Search / io.github.ni-c/carddav-mcp
protogridL0· runs locallyRead and write CardDAV address books: contacts, groups and photos over the open standard
v0.1.3 · active · repository · website · descriptor JSON · versions
{
"mcpServers": {
"carddav-mcp": {
"command": "npx",
"args": [
"-y",
"@ni-c/[email protected]"
],
"env": {
"CARDDAV_URL": "${CARDDAV_URL}",
"CARDDAV_PASSWORD": "${CARDDAV_PASSWORD}",
"CARDDAV_TOKEN": "${CARDDAV_TOKEN}"
}
}
}
}claude mcp add carddav-mcp -e "CARDDAV_URL=${CARDDAV_URL}" -e "CARDDAV_PASSWORD=${CARDDAV_PASSWORD}" -e "CARDDAV_TOKEN=${CARDDAV_TOKEN}" -- npx -y @ni-c/[email protected][mcp_servers.carddav-mcp]
command = "npx"
args = ["-y", "@ni-c/[email protected]"]
env = { "CARDDAV_URL" = "${CARDDAV_URL}", "CARDDAV_PASSWORD" = "${CARDDAV_PASSWORD}", "CARDDAV_TOKEN" = "${CARDDAV_TOKEN}" }
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"carddav-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"@ni-c/[email protected]"
],
"enabled": true,
"environment": {
"CARDDAV_URL": "{env:CARDDAV_URL}",
"CARDDAV_PASSWORD": "{env:CARDDAV_PASSWORD}",
"CARDDAV_TOKEN": "{env:CARDDAV_TOKEN}"
}
}
}
}{
"mcpServers": {
"carddav-mcp": {
"command": "npx",
"args": [
"-y",
"@ni-c/[email protected]"
],
"env": {
"CARDDAV_URL": "${CARDDAV_URL}",
"CARDDAV_PASSWORD": "${CARDDAV_PASSWORD}",
"CARDDAV_TOKEN": "${CARDDAV_TOKEN}"
}
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=carddav-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBuaS1jL2NhcmRkYXYtbWNwQDAuMS4zIl0sImVudiI6eyJDQVJEREFWX1VSTCI6IiR7Q0FSRERBVl9VUkx9IiwiQ0FSRERBVl9QQVNTV09SRCI6IiR7Q0FSRERBVl9QQVNTV09SRH0iLCJDQVJEREFWX1RPS0VOIjoiJHtDQVJEREFWX1RPS0VOfSJ9fQ%3D%3D"
}{
"servers": {
"carddav-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ni-c/[email protected]"
],
"env": {
"CARDDAV_URL": "${CARDDAV_URL}",
"CARDDAV_PASSWORD": "${CARDDAV_PASSWORD}",
"CARDDAV_TOKEN": "${CARDDAV_TOKEN}"
}
}
}
}{
"mcpServers": {
"carddav-mcp": {
"command": "npx",
"args": [
"-y",
"@ni-c/[email protected]"
],
"env": {
"CARDDAV_URL": "${CARDDAV_URL}",
"CARDDAV_PASSWORD": "${CARDDAV_PASSWORD}",
"CARDDAV_TOKEN": "${CARDDAV_TOKEN}"
}
}
}
}extensions:
"carddav-mcp":
enabled: true
name: "carddav-mcp"
type: stdio
cmd: "npx"
args:
- "-y"
- "@ni-c/[email protected]"
envs:
"CARDDAV_URL": "${CARDDAV_URL}"
"CARDDAV_PASSWORD": "${CARDDAV_PASSWORD}"
"CARDDAV_TOKEN": "${CARDDAV_TOKEN}"
timeout: 300
Placeholders to fill from your own secret store: ${CARDDAV_PASSWORD}, ${CARDDAV_TOKEN}. The registry never accepts secret values.
This is a local package: the command runs on your machine.
Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)auth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)stability.changes, stability.rug_pulltool list unknowndeps.known_vulnsno known advisory in 17 resolved packagesdeps.mcp_sdk_version@modelcontextprotocol/server 2.1.0, no known advisorydeps.resolvable@ni-c/[email protected] resolved: 17 packagesNo tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo +website ~liveness-unmeasured ~updated-42d-ago -unpinned-packages(1)
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
@ni-c/[email protected] npm16 dependencies, resolved · MCP SDK @modelcontextprotocol/server 2.1.0 · advisories checked 2026-10-19
No known advisory affects this dependency graph.
Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.
| package | registry | version | runtime | secrets |
|---|---|---|---|---|
@ni-c/carddav-mcp | npm | 0.1.3 | – | CARDDAV_PASSWORD, CARDDAV_TOKEN |
ghcr.io/ni-c/carddav-mcp:0.1.3 | oci | unpinned | – | CARDDAV_PASSWORD, CARDDAV_TOKEN |
No tools observed. Local packages are never executed by the registry.
Schemas: list_tools.
And 13 more from this publisher.
{
"name": "io.github.ni-c/carddav-mcp",
"icons": [
{
"src": "https://carddav-mcp.ni-c.de/icon-512.png",
"sizes": [
"512x512"
],
"mimeType": "image/png"
},
{
"src": "https://carddav-mcp.ni-c.de/favicon.svg",
"sizes": [
"any"
],
"mimeType": "image/svg+xml"
}
],
"title": "CardDAV address books",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"version": "0.1.3",
"packages": [
{
"version": "0.1.3",
"transport": {
"type": "stdio"
},
"identifier": "@ni-c/carddav-mcp",
"registryType": "npm",
"environmentVariables": [
{
"name": "CARDDAV_URL",
"format": "string",
"isRequired": true,
"description": "Root of the CardDAV server, e.g. https://dav.example.net. An address book collection URL also works."
},
{
"name": "CARDDAV_USERNAME",
"format": "string",
"description": "Account name. Most hosted services want an app-specific password with it."
},
{
"name": "CARDDAV_PASSWORD",
"format": "string",
"isSecret": true,
"description": "Password or app-specific password. Deleted from the environment once read."
},
{
"name": "CARDDAV_TOKEN",
"format": "string",
"isSecret": true,
"description": "Bearer token, as an alternative to username and password. Not both."
},
{
"name": "CARDDAV_ADDRESSBOOKS",
"format": "string",
"description": "Comma-separated address books this server may touch, by path or final path segment. Default: all of them."
},
{
"name": "CARDDAV_MAX_CONTACTS",
"format": "number",
"description": "Contacts a listing returns by default, 1 to 500 (default: 100)"
},
{
"name": "CARDDAV_READ_ONLY",
"format": "boolean",
"description": "Set to true to register only the read tools (default: false)"
},
{
"name": "CARDDAV_INSECURE_TLS",
"format": "boolean",
"description": "Set to true to accept a self-signed certificate on the configured host only (default: false)"
},
{
"name": "CARDDAV_ALLOW_PLAINTEXT",
"format": "boolean",
"description": "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)"
},
{
"name": "CARDDAV_ALLOW_TOOLS",
"format": "string",
"description": "Comma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)"
},
{
"name": "CARDDAV_DENY_TOOLS",
"format": "string",
"description": "Comma-separated tool names or list_* prefixes to remove from whatever the allow list left"
},
{
"name": "ELICITATION",
"format": "boolean",
"description": "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)"
}
]
},
{
"transport": {
"type": "stdio"
},
"identifier": "ghcr.io/ni-c/carddav-mcp:0.1.3",
"registryType": "oci",
"environmentVariables": [
{
"name": "CARDDAV_URL",
"format": "string",
"isRequired": true,
"description": "Root of the CardDAV server, e.g. https://dav.example.net. An address book collection URL also works."
},
{
"name": "CARDDAV_USERNAME",
"format": "string",
"description": "Account name. Most hosted services want an app-specific password with it."
},
{
"name": "CARDDAV_PASSWORD",
"format": "string",
"isSecret": true,
"description": "Password or app-specific password. Deleted from the environment once read."
},
{
"name": "CARDDAV_TOKEN",
"format": "string",
"isSecret": true,
"description": "Bearer token, as an alternative to username and password. Not both."
},
{
"name": "CARDDAV_ADDRESSBOOKS",
"format": "string",
"description": "Comma-separated address books this server may touch, by path or final path segment. Default: all of them."
},
{
"name": "CARDDAV_MAX_CONTACTS",
"format": "number",
"description": "Contacts a listing returns by default, 1 to 500 (default: 100)"
},
{
"name": "CARDDAV_READ_ONLY",
"format": "boolean",
"description": "Set to true to register only the read tools (default: false)"
},
{
"name": "CARDDAV_INSECURE_TLS",
"format": "boolean",
"description": "Set to true to accept a self-signed certificate on the configured host only (default: false)"
},
{
"name": "CARDDAV_ALLOW_PLAINTEXT",
"format": "boolean",
"description": "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)"
},
{
"name": "CARDDAV_ALLOW_TOOLS",
"format": "string",
"description": "Comma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)"
},
{
"name": "CARDDAV_DENY_TOOLS",
"format": "string",
"description": "Comma-separated tool names or list_* prefixes to remove from whatever the allow list left"
},
{
"name": "ELICITATION",
"format": "boolean",
"description": "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)"
}
]
}
],
"repository": {
"url": "https://github.com/ni-c/carddav-mcp",
"source": "github"
},
"websiteUrl": "https://carddav-mcp.ni-c.de",
"description": "Read and write CardDAV address books: contacts, groups and photos over the open standard"
}