CardDAV address books for Gemini CLI

io.github.ni-c/carddav-mcp

Read and write CardDAV address books: contacts, groups and photos over the open standard

client:Gemini CLI transport:stdio runtime:npm

Install CardDAV address books in Gemini CLI

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

CARDDAV_URL

CARDDAV_USERNAME

CARDDAV_PASSWORD

CARDDAV_TOKEN

CARDDAV_ADDRESSBOOKS

CARDDAV_MAX_CONTACTS

CARDDAV_READ_ONLY

CARDDAV_INSECURE_TLS

CARDDAV_ALLOW_PLAINTEXT

CARDDAV_ALLOW_TOOLS

CARDDAV_DENY_TOOLS

ELICITATION

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

{
  "mcpServers": {
    "carddav-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/carddav-mcp"
      ],
      "env": {
        "CARDDAV_URL": "<CARDDAV_URL>",
        "CARDDAV_USERNAME": "<CARDDAV_USERNAME>",
        "CARDDAV_PASSWORD": "<CARDDAV_PASSWORD>",
        "CARDDAV_TOKEN": "<CARDDAV_TOKEN>",
        "CARDDAV_ADDRESSBOOKS": "<CARDDAV_ADDRESSBOOKS>",
        "CARDDAV_MAX_CONTACTS": "<CARDDAV_MAX_CONTACTS>",
        "CARDDAV_READ_ONLY": "<CARDDAV_READ_ONLY>",
        "CARDDAV_INSECURE_TLS": "<CARDDAV_INSECURE_TLS>",
        "CARDDAV_ALLOW_PLAINTEXT": "<CARDDAV_ALLOW_PLAINTEXT>",
        "CARDDAV_ALLOW_TOOLS": "<CARDDAV_ALLOW_TOOLS>",
        "CARDDAV_DENY_TOOLS": "<CARDDAV_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

CardDAV address books in other clients

CardDAV address books MCP server