the-real-bitwarden-mcp

security MCP Server

Local stdio MCP server for Bitwarden (Public API + Secrets Manager). 50+ admin tools for members, groups, collections, policies, licensing, projects, and secrets. For Claude Desktop / Claude Code.

VerifiedInstall Ready
securitysecurity
2 views0 stars0 forksv0.1.0MIT

Why This Matters

Discovered via github-topic:model-context-protocol and last synced 3mo ago.

VerifiedInstall Ready
Source
github-topic:model-context-protocol
Stars
0
Last synced
3mo ago
Install
Instructions detected

Install

1. Install the package

npx the-real-bitwarden-mcp

2. Add to claude_desktop_config.json

{
  "mcpServers": {
    "the-real-bitwarden-mcp": {
      "command": "npx",
      "args": [
        "the-real-bitwarden-mcp"
      ]
    }
  }
}

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows)

23
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (23)

BITWARDEN_SELFHOST_CLIENT_ID

self-host mode

present

present

bw_event_query

Defaults to last 24 h when `start`/`end` are omitted

BITWARDEN_CLOUD_CLIENT_SECRET

cloud mode

0

Version prefix

available

available

BITWARDEN_CLOUD_IDENTITY_URL

cloud mode

BITWARDEN_CLOUD_CLIENT_ID

cloud mode

Part

Value

BWS_ACCESS_TOKEN

SM tools

Tool

Default fields

BITWARDEN_SELFHOST_IDENTITY_URL

self-host mode

BWS_ORG_ID

SM project/secret create/list

bw_group_list

`id`, `name`, `externalId`

BITWARDEN_SELFHOST_CLIENT_SECRET

self-host mode

BITWARDEN_CLOUD_API_BASE

cloud mode

stubbed

On unsupported platforms the MCP still starts and all Public-API tools work normally. The `bws_project_*` and `bws_secret_*` tools return "Secrets Manager SDK not available on this platform" at call time. If Bitwarden ships SDK binaries for a new platform, simply `npm install` will pick them up — no MCP code change needed. ## Setup ```bash git clone <repo-url> cd <repo> npm install # also pulls the platform-specific SDK binary automatically cp .env.example .env # Fill in .env — see "Configuration". npm run refresh-spec # pull Swagger from your self-host (optional) npm run generate # build the generated tool list (optional) npm run build ``` The SDK binary is an optional dependency — `npm install` succeeds even on unsupported platforms (the binary simply won't be present, and SM tools will return a clear "not available" message). ## Configuration All values are read from `.env`. **At least one instance must be fully configured**, otherwise the server refuses to start.

BITWARDEN_SELFHOST_API_BASE

self-host mode

BWS_IDENTITY_URL

SM tools (optional)

bw_collection_list

`id`, `externalId`

BWS_API_BASE

SM tools (optional)

bw_member_list

`id`, `email`, `name`, `type`, `status`, `twoFactorEnabled`

absent

absent