CardDAV address books

stdio

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

Getting Started

npx @getmcp/cli add io.github.ni-c/carddav-mcp

Requires Node.js 18+. Community-contributed server. Review source before installing.

Claude Desktopguide →Vscodeguide →Cursorguide →Windsurfguide →

Required Environment Variables

CARDDAV_URL
Root of the CardDAV server, e.g. https://dav.example.net. An address book collection URL also works.

Configuration

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json

JSON

{
  "mcpServers": {
    "io.github.ni-c/carddav-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/carddav-mcp"
      ],
      "env": {
        "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": ""
      }
    }
  }
}

Claude Desktop MCP documentation