CalDAV calendars for Gemini CLI

io.github.ni-c/caldav-mcp

Read and write CalDAV calendars: events, tasks and journal entries over the open standard

client:Gemini CLI transport:stdio runtime:npm

Install CalDAV calendars in Gemini CLI

~/.gemini/settings.json · windows: %USERPROFILE%\.gemini\settings.json

CALDAV_URL

CALDAV_USERNAME

CALDAV_PASSWORD

CALDAV_TOKEN

CALDAV_CALENDARS

CALDAV_TIMEZONE

CALDAV_USER_EMAIL

CALDAV_MAX_EVENTS

CALDAV_READ_ONLY

CALDAV_INSECURE_TLS

CALDAV_ALLOW_PLAINTEXT

CALDAV_ALLOW_TOOLS

CALDAV_DENY_TOOLS

ELICITATION

Held in this page only — never stored, logged, or sent anywhere but back to your screen.

{
  "mcpServers": {
    "caldav-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/caldav-mcp"
      ],
      "env": {
        "CALDAV_URL": "<CALDAV_URL>",
        "CALDAV_USERNAME": "<CALDAV_USERNAME>",
        "CALDAV_PASSWORD": "<CALDAV_PASSWORD>",
        "CALDAV_TOKEN": "<CALDAV_TOKEN>",
        "CALDAV_CALENDARS": "<CALDAV_CALENDARS>",
        "CALDAV_TIMEZONE": "<CALDAV_TIMEZONE>",
        "CALDAV_USER_EMAIL": "<CALDAV_USER_EMAIL>",
        "CALDAV_MAX_EVENTS": "<CALDAV_MAX_EVENTS>",
        "CALDAV_READ_ONLY": "<CALDAV_READ_ONLY>",
        "CALDAV_INSECURE_TLS": "<CALDAV_INSECURE_TLS>",
        "CALDAV_ALLOW_PLAINTEXT": "<CALDAV_ALLOW_PLAINTEXT>",
        "CALDAV_ALLOW_TOOLS": "<CALDAV_ALLOW_TOOLS>",
        "CALDAV_DENY_TOOLS": "<CALDAV_DENY_TOOLS>",
        "ELICITATION": "<ELICITATION>"
      }
    }
  }
}

Gemini expands $VAR and ${VAR} inside env values, so a secret can live in your shell rather than this file. Gemini CLI docs

CalDAV calendars in other clients

CalDAV calendars MCP server