Pim MCP
Local MCP server that merges Nextcloud, iCloud, Google and CalDAV calendars into one view
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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"pim-mcp": {
"command": "npx",
"args": [
"-y",
"pim-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"pim-mcp": {
"command": "npx",
"args": [
"-y",
"pim-mcp"
]
}
}
}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.
