Skip to content
MCP server

Pim MCP

Local MCP server that merges Nextcloud, iCloud, Google and CalDAV calendars into one view

Runs locally
Install

Pim MCP is an MCP server for productivity. It runs locally on your machine and is started by your AI client.

Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.2.0
Listing updated

Similar MCP servers

Install

Run in a terminal

claude mcp add pim-mcp -- npx -y pim-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "pim-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pim-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pim-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pim-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "pim-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "pim-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pim-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pim-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "pim-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pim-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

About Pim MCP

Pim MCP runs on your machine over stdio and talks to your calendars through CalDAV, with OAuth for Google. It merges every calendar across accounts into one sorted list with recurring events expanded, so an assistant no longer needs to know which account holds an event. A sample exchange finds a free hour on Thursday afternoon and books a dentist appointment in an iCloud calendar.

Secrets stay out of the config. The single TOML file holds references to your OS keychain, environment variables or a command such as 1Password or pass, so the same file works on every machine. macOS uses Keychain, Linux the Secret Service, and Windows DPAPI.

Guardrails are on by default: deleting events and anything that emails other people stay off until allowed, and edits never overwrite changes made elsewhere. Nothing runs in the background and no port is opened. It requires Node.js 22 or later.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

list_calendars
All calendars and their ids
list_events
Events from all calendars in a range, merged and sorted
find_free_time
Find open slots in a range
create_event
Create an event in a calendar

What it does

Merged calendar view
All calendars from all accounts in one sorted list.
Four account types
Nextcloud, iCloud, Google and any CalDAV server.
Secret references
Config points at keychain, env vars or commands instead of holding passwords.
Safe by default
Deletes and event invitations are off until you enable them.
Conflict-safe edits
Edits never overwrite changes made elsewhere.
Account check
pim-mcp check verifies each account and lists its calendars.

Good for

  • Find a free hour across personal and work calendars
  • Book an appointment by chat
  • Review a week of events in several accounts
  • Use the same setup on several computers

Pim MCP FAQ

Which calendars are supported?

Nextcloud, iCloud, Google and any CalDAV server.

How are passwords stored?

As references to your OS secret store, env vars or a password-manager command.

Does Pim MCP run in the background?

No. Your client starts it over stdio when needed and no port is opened.

What does Google need?

A one-time OAuth setup with a Desktop app client ID.

How do I add Pim MCP to Claude Code?

Run this command in your terminal: claude mcp add pim-mcp -- npx -y pim-mcp

What are the best alternatives to Pim MCP?

The closest alternatives to Pim MCP are icloud-mcp, Icloud Calendar MCP, AllMyMeetings, Keeper.sh and SYNCDATE.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers