# Pim MCP

> Pim MCP is an MCP server for productivity. Local MCP server that merges Nextcloud, iCloud, Google and CalDAV calendars into one view. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, macOS, Linux, Windows
- **Repository:** https://github.com/da-the-dev/pim-mcp
- **MCP Registry name:** io.github.da-the-dev/pim-mcp
- **Categories:** [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add pim-mcp -- npx -y pim-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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.

## Alternatives

- [icloud-mcp](https://ai-powered.com/mcp/icloud-mcp-3): icloud-mcp is an open-source MCP server for productivity.
- [Icloud Calendar MCP](https://ai-powered.com/mcp/icloud-calendar-mcp): Icloud Calendar MCP is an open-source MCP server for productivity.
- [AllMyMeetings](https://ai-powered.com/mcp/allmymeetings): AllMyMeetings is a freemium MCP server for productivity.
- [Keeper.sh](https://ai-powered.com/mcp/keeper-sh): Keeper.sh is a freemium MCP server for productivity.
- [SYNCDATE](https://ai-powered.com/mcp/syncdate): SYNCDATE is a freemium MCP server for productivity.
- [Kalender Sync](https://ai-powered.com/mcp/kalender-sync): Kalender Sync is a freemium MCP server for productivity.
- [Apple Calendar](https://ai-powered.com/mcp/apple-calendar-2): Apple Calendar is an open-source MCP server for productivity.
- [Apple Calendar](https://ai-powered.com/mcp/apple-calendar): Apple Calendar is an open-source MCP server for productivity.

---
Source: https://ai-powered.com/mcp/pim-mcp
