Citadel MCP Server

by yp3y5akh0vdev.citadeldb/mcpv2.7.0

Encrypted-first embedded database with vector search and agent memory, exposed as MCP tools

3Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active12d ago

Install Citadel MCP server

claude mcp add citadel -e CITADEL_KEY='<citadel-key>' -- uvx citadeldb-mcp --db '<--db>' --embedder '<--embedder>'

{
  "mcpServers": {
    "citadel": {
      "command": "uvx",
      "args": [
        "citadeldb-mcp",
        "--db",
        "<--db>",
        "--embedder",
        "<--embedder>"
      ],
      "env": {
        "CITADEL_KEY": "<citadel-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "citadel": {
      "command": "uvx",
      "args": [
        "citadeldb-mcp",
        "--db",
        "<--db>",
        "--embedder",
        "<--embedder>"
      ],
      "env": {
        "CITADEL_KEY": "<citadel-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "citadel": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "citadeldb-mcp",
        "--db",
        "<--db>",
        "--embedder",
        "<--embedder>"
      ],
      "env": {
        "CITADEL_KEY": "<citadel-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "citadel": {
      "command": "uvx",
      "args": [
        "citadeldb-mcp",
        "--db",
        "<--db>",
        "--embedder",
        "<--embedder>"
      ],
      "env": {
        "CITADEL_KEY": "<citadel-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
CITADEL_KEY	yes	yes	Passphrase used to unlock the encrypted Citadel database

Freshness

Active — last maintenance signal 12d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-27 · 12d ago · GitHub
Latest release
2026-09-28 · 12d ago · GitHub · v2.7.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-28 · 12d ago · official registry · v2.7.0

FAQ

›How do I install the Citadel MCP server in Claude Code?

Run: claude mcp add citadel -e CITADEL_KEY='<citadel-key>' -- uvx citadeldb-mcp --db '<--db>' --embedder '<--embedder>'. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Citadel require an API key?

Yes. It expects CITADEL_KEY, of which 1 is a secret.

›Can I use Citadel as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Citadel in the official MCP registry?

Yes, as dev.citadeldb/mcp.