Skip to content
Bitwarden Public API and Secrets Manager (unofficial)
Install guide · Claude Desktop

Install Bitwarden Public API and Secrets Manager (unofficial) for Claude Desktop

Claude Desktop reads mcpServers from claude_desktop_config.json. Restart the app after saving.

  1. Open ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows, or ~/.config/Claude/claude_desktop_config.json on Linux.

  2. Paste the JSON config below.

  3. Replace placeholder secrets, then restart the client if it does not reload on its own.

~/Library/Application Support/Claude/claude_desktop_config.json
{  "mcpServers": {    "mguttmann-the-real-bitwarden-mcp": {      "command": "npx",      "args": [        "-y",        "the-real-bitwarden-mcp@0.3.1"      ],      "env": {        "BITWARDEN_SELFHOST_API_BASE": "",        "BITWARDEN_SELFHOST_IDENTITY_URL": "",        "BITWARDEN_SELFHOST_CLIENT_ID": "",        "BITWARDEN_SELFHOST_CLIENT_SECRET": "YOUR_BITWARDEN_SELFHOST_CLIENT_SECRET",        "BITWARDEN_CLOUD_API_BASE": "",        "BITWARDEN_CLOUD_IDENTITY_URL": "",        "BITWARDEN_CLOUD_CLIENT_ID": "",        "BITWARDEN_CLOUD_CLIENT_SECRET": "YOUR_BITWARDEN_CLOUD_CLIENT_SECRET",        "BWS_ACCESS_TOKEN": "YOUR_BWS_ACCESS_TOKEN",        "BWS_ORG_ID": "",        "BWS_API_BASE": "",        "BWS_IDENTITY_URL": "",        "BITWARDEN_CONFIRM_WRITES": "true",        "BITWARDEN_READ_ONLY": "false",        "LOG_LEVEL": "warn",        "BW_MCP_MAX_RESPONSE_BYTES": "1048576"      }    }  }}

Where the config lives

SystemPath
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json
Linux~/.config/Claude/claude_desktop_config.json