CardDAV address books MCP Server

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

claude mcp add carddav-mcp -e 'CARDDAV_URL=<CARDDAV_URL>' -- npx -y @ni-c/carddav-mcp

{
  "mcpServers": {
    "carddav-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/carddav-mcp"
      ],
      "env": {
        "CARDDAV_URL": "<CARDDAV_URL>"
      }
    }
  }
}

[mcp_servers.carddav-mcp]
command = "npx"
args = ["-y", "@ni-c/carddav-mcp"]
env = { CARDDAV_URL = "<CARDDAV_URL>" }

{
  "mcpServers": {
    "carddav-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/carddav-mcp"
      ],
      "env": {
        "CARDDAV_URL": "<CARDDAV_URL>"
      }
    }
  }
}

{
  "servers": {
    "carddav-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/carddav-mcp"
      ],
      "env": {
        "CARDDAV_URL": "<CARDDAV_URL>"
      }
    }
  }
}

Put your own value in place of <CARDDAV_URL> (Root of the CardDAV server, e.g. https://dav.example.net. An address book collection URL also works). The author’s registry entry marks it as required.

Optional settings from the registry entry, left out of the block above: CARDDAV_USERNAME (Account name. Most hosted services want an app-specific password with it), CARDDAV_PASSWORD (Password or app-specific password. Deleted from the environment once read), CARDDAV_TOKEN (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)).