CardDAV address books MCP Server

io.github.ni-c/carddav-mcp

Repository Registry

What is the CardDAV address books MCP server?

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

How to install CardDAV address books

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

CARDDAV_URL
required
Root of the CardDAV server, e.g. https://dav.example.net. An address book collection URL also works.
CARDDAV_USERNAME
Account name. Most hosted services want an app-specific password with it.
CARDDAV_PASSWORD
secret
Password or app-specific password. Deleted from the environment once read.
CARDDAV_TOKEN
secret
Bearer token, as an alternative to username and password. Not both.
CARDDAV_ADDRESSBOOKS
Comma-separated address books this server may touch, by path or final path segment. Default: all of them.
CARDDAV_MAX_CONTACTS
Contacts a listing returns by default, 1 to 500 (default: 100)
CARDDAV_READ_ONLY
Set to true to register only the read tools (default: false)
CARDDAV_INSECURE_TLS
Set to true to accept a self-signed certificate on the configured host only (default: false)
CARDDAV_ALLOW_PLAINTEXT
Set to true to allow a plain http:// URL to a host that is not loopback, which sends the credentials and every contact unencrypted (default: false)
CARDDAV_ALLOW_TOOLS
Comma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)
CARDDAV_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)

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "carddav-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/carddav-mcp"
      ],
      "env": {
        "CARDDAV_URL": "<YOUR_CARDDAV_URL>",
        "CARDDAV_USERNAME": "<YOUR_CARDDAV_USERNAME>",
        "CARDDAV_PASSWORD": "<YOUR_CARDDAV_PASSWORD>",
        "CARDDAV_TOKEN": "<YOUR_CARDDAV_TOKEN>",
        "CARDDAV_ADDRESSBOOKS": "<YOUR_CARDDAV_ADDRESSBOOKS>",
        "CARDDAV_MAX_CONTACTS": "<YOUR_CARDDAV_MAX_CONTACTS>",
        "CARDDAV_READ_ONLY": "<YOUR_CARDDAV_READ_ONLY>",
        "CARDDAV_INSECURE_TLS": "<YOUR_CARDDAV_INSECURE_TLS>",
        "CARDDAV_ALLOW_PLAINTEXT": "<YOUR_CARDDAV_ALLOW_PLAINTEXT>",
        "CARDDAV_ALLOW_TOOLS": "<YOUR_CARDDAV_ALLOW_TOOLS>",
        "CARDDAV_DENY_TOOLS": "<YOUR_CARDDAV_DENY_TOOLS>",
        "ELICITATION": "<YOUR_ELICITATION>"
      }
    }
  }
}