CalDAV calendars MCP Server

by ni-cio.github.ni-c/caldav-mcpv0.1.4

Events, tasks and journal entries on any CalDAV server (Radicale, Nextcloud, Fastmail, iCloud), with a calendar allowlist and approval for series changes.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active4d ago

Install CalDAV calendars MCP server

claude mcp add caldav-ni-c -e CALDAV_URL='<caldav-url>' -e CALDAV_PASSWORD='<caldav-password>' -e CALDAV_TOKEN='<caldav-token>' -- npx -y @ni-c/caldav-mcp

{
  "mcpServers": {
    "caldav-ni-c": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/caldav-mcp"
      ],
      "env": {
        "CALDAV_URL": "<caldav-url>",
        "CALDAV_PASSWORD": "<caldav-password>",
        "CALDAV_TOKEN": "<caldav-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "caldav-ni-c": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/caldav-mcp"
      ],
      "env": {
        "CALDAV_URL": "<caldav-url>",
        "CALDAV_PASSWORD": "<caldav-password>",
        "CALDAV_TOKEN": "<caldav-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "caldav-ni-c": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/caldav-mcp"
      ],
      "env": {
        "CALDAV_URL": "<caldav-url>",
        "CALDAV_PASSWORD": "<caldav-password>",
        "CALDAV_TOKEN": "<caldav-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "caldav-ni-c": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/caldav-mcp"
      ],
      "env": {
        "CALDAV_URL": "<caldav-url>",
        "CALDAV_PASSWORD": "<caldav-password>",
        "CALDAV_TOKEN": "<caldav-token>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
CALDAV_URL	yes	—	Root of the CalDAV server, e.g. https://dav.example.net. A calendar collection URL also works.
CALDAV_USERNAME	—	—	Account name. Most hosted services want an app-specific password with it.
CALDAV_PASSWORD	—	yes	Password or app-specific password. Deleted from the environment once read.
CALDAV_TOKEN	—	yes	Bearer token, as an alternative to username and password. Not both.
CALDAV_CALENDARS	—	—	Comma-separated calendars this server may touch, by path or final path segment. Default: all of them.
CALDAV_TIMEZONE	—	—	IANA zone for timestamps that carry no offset, e.g. Europe/Berlin (default: UTC)
CALDAV_USER_EMAIL	—	—	The address you are invited as, so respond_to_event can find your own attendee line
CALDAV_MAX_EVENTS	—	—	Entries a listing returns by default, 1 to 500 (default: 100)
CALDAV_READ_ONLY	—	—	Set to true to register only the read tools (default: false)
CALDAV_INSECURE_TLS	—	—	Set to true to accept a self-signed certificate on the configured host only (default: false)
CALDAV_ALLOW_PLAINTEXT	—	—	Set to true to allow a plain http:// URL to a host that is not loopback, which sends the credentials unencrypted (default: false)
CALDAV_ALLOW_TOOLS	—	—	Comma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)
CALDAV_DENY_TOOLS	—	—	Comma-separated tool names or list_* prefixes to remove from whatever the allow list left
ELICITATION	—	—	Deliberately unprefixed, and reaches every MCP server in the environment. Set to false to make guarded tools use the two-call token instead of a dialog (default: true)

Freshness

Active — last maintenance signal 4d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-06 · 4d ago · GitHub
Latest release
2026-09-08 · 32d ago · GitHub · v0.1.4
Package published
no data · npm/PyPI
Registry entry updated
2026-09-08 · 32d ago · official registry · v0.1.4

FAQ

›How do I install the CalDAV calendars MCP server in Claude Code?

Run: claude mcp add caldav-ni-c -e CALDAV_URL='<caldav-url>' -e CALDAV_PASSWORD='<caldav-password>' -e CALDAV_TOKEN='<caldav-token>' -- npx -y @ni-c/caldav-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does CalDAV calendars require an API key?

Yes. It expects CALDAV_URL, CALDAV_PASSWORD, CALDAV_TOKEN, of which 2 are secrets.

›Can I use CalDAV calendars as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is CalDAV calendars in the official MCP registry?

Yes, as io.github.ni-c/caldav-mcp.