Listed from the MCP registry; nobody on Odel publishes it.
CardDAV contacts as MCP tools: list address books; list, get, create, update and delete contacts.
Runs on your machine from its package; the steps are below.
Not assessed yet.
Odel charges nothing per call. The publisher may charge for its own service.
Runs locally over stdio
This server isn't hosted โ your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).
Run
npx -y carddav-mcp
MCP client config
{
"mcpServers": {
"carddav": {
"command": "npx",
"args": [
"-y",
"carddav-mcp"
]
}
}
}๐ A CardDAV Model Context Protocol (MCP) server to expose contacts and address books as tools for AI assistants.
Maintained by the team behind Langmail. Want mail, calendar and contacts for your agent over one hosted MCP, with OAuth and nothing to run? โ langmail.me
{
"mcpServers": {
...,
"contacts": {
"command": "npx",
"args": [
"carddav-mcp"
],
"env": {
"CARDDAV_BASE_URL": "<CardDAV server URL>",
"CARDDAV_USERNAME": "<CardDAV username>",
"CARDDAV_PASSWORD": "<CardDAV password>"
}
}
}
}
Run the MCP server in development mode with auto-reload:
npm run dev
This will run the TypeScript code directly with watch mode and automatically load environment variables from .env.
Alternatively, you can compile TypeScript to JavaScript and run it:
npx tsc
node dist/index.js
List all address books returning both name and URL
Parameters: none
Returns:
List all contacts in the address book specified by its URL. Returns a summary per contact; use get-contact for full details.
Parameters:
addressBookUrl: stringReturns:
uid, fn (formatted name), emails, and phonesGet the full details of a single contact in the address book specified by its URL
Parameters:
uid: string โ Unique identifier of the contact to fetch (obtained from list-contacts)addressBookUrl: stringReturns:
uid, fn, name, emails, phones, and optionally org, title, note) plus the raw vCard in vcardCreates a contact (vCard) in the address book specified by its URL. If name is omitted, structured name parts are derived from fn.
Parameters:
addressBookUrl: stringfn: string โ Formatted display name of the contactname: object (optional) โ Structured name parts (family, given, middle, ...)
family: string (optional)given: string (optional)middle: string (optional)prefix: string (optional)suffix: string (optional)emails: array of string (optional)phones: array of string (optional)org: string (optional) โ Organization / companytitle: string (optional) โ Job title or rolenote: string (optional)Returns:
Updates an existing contact in the address book specified by its URL. Only provided fields are changed; emails and phones replace the full list (pass an empty array to clear them, or an empty string to clear org, title, or note). Other vCard properties are preserved.
Parameters:
uid: string โ Unique identifier of the contact to update (obtained from list-contacts)addressBookUrl: stringfn: string (optional)name: object (optional)
family: string (optional)given: string (optional)middle: string (optional)prefix: string (optional)suffix: string (optional)emails: array of string (optional)phones: array of string (optional)org: string (optional)title: string (optional)note: string (optional)Returns:
Deletes a contact in the address book specified by its URL
Parameters:
uid: string โ Unique identifier of the contact to delete (obtained from list-contacts)addressBookUrl: stringReturns:
Two complementary end-to-end checks against a real CardDAV server (both read credentials from .env):
npm run smoke โ deterministic SDK harness (scripts/smoke.ts). Spawns the built server over stdio via the MCP client SDK and asserts the create โ list โ get โ update โ delete contact round-trip.npm run smoke:agent โ agent-ergonomics harness (scripts/smoke-agent.sh). Drives the server via claude -p with a JSON output schema, validating that tool names, descriptions, schemas, and error messages are usable by an LLM.