Bitwarden Public API and Secrets Manager (unofficial)

Name: Bitwarden Public API and Secrets Manager (unofficial)
Author: mguttmann

作者：mguttmannバージョン 0.3.1i★ –iパソコンで動く

レジストリ名io.github.mguttmann/the-real-bitwarden-mcp

インストール

概要

作者による説明（英語の原文）

Unofficial MCP server for the Bitwarden Public API and Secrets Manager, self-hosted or cloud.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況iとても新しい↓ 139/週 · ★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: サイバーセキュリティ
入力が必要なもの：BITWARDEN_SELFHOST_CLIENT_SECRET, BITWARDEN_CLOUD_CLIENT_SECRET, BWS_ACCESS_TOKEN

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：1項目中1項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
自分で入力するもの： BITWARDEN_SELFHOST_API_BASE, BITWARDEN_SELFHOST_IDENTITY_URL, BITWARDEN_SELFHOST_CLIENT_ID, BITWARDEN_SELFHOST_CLIENT_SECRET, BITWARDEN_CLOUD_API_BASE, BITWARDEN_CLOUD_IDENTITY_URL, BITWARDEN_CLOUD_CLIENT_ID, BITWARDEN_CLOUD_CLIENT_SECRET, BWS_ACCESS_TOKEN, BWS_ORG_ID, BWS_API_BASE, BWS_IDENTITY_URL, BITWARDEN_CONFIRM_WRITES, BITWARDEN_READ_ONLY, LOG_LEVEL, BW_MCP_MAX_RESPONSE_BYTES

「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。

必要なもの

npmNode.jsのインストール（npxコマンドに必要）

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

{
  "mcpServers": {
    "the-real-bitwarden": {
      "command": "npx",
      "args": [
        "-y",
        "the-real-bitwarden-mcp"
      ],
      "env": {
        "BITWARDEN_SELFHOST_API_BASE": "your-value",
        "BITWARDEN_SELFHOST_IDENTITY_URL": "your-value",
        "BITWARDEN_SELFHOST_CLIENT_ID": "your-value",
        "BITWARDEN_SELFHOST_CLIENT_SECRET": "your-value",
        "BITWARDEN_CLOUD_API_BASE": "your-value",
        "BITWARDEN_CLOUD_IDENTITY_URL": "your-value",
        "BITWARDEN_CLOUD_CLIENT_ID": "your-value",
        "BITWARDEN_CLOUD_CLIENT_SECRET": "your-value",
        "BWS_ACCESS_TOKEN": "your-value",
        "BWS_ORG_ID": "your-value",
        "BWS_API_BASE": "your-value",
        "BWS_IDENTITY_URL": "your-value",
        "BITWARDEN_CONFIRM_WRITES": "your-value",
        "BITWARDEN_READ_ONLY": "your-value",
        "LOG_LEVEL": "your-value",
        "BW_MCP_MAX_RESPONSE_BYTES": "your-value"
      }
    }
  }
}

ターミナルでこれを実行します

claude mcp add the-real-bitwarden --env BITWARDEN_SELFHOST_API_BASE=your-value --env BITWARDEN_SELFHOST_IDENTITY_URL=your-value --env BITWARDEN_SELFHOST_CLIENT_ID=your-value --env BITWARDEN_SELFHOST_CLIENT_SECRET=your-value --env BITWARDEN_CLOUD_API_BASE=your-value --env BITWARDEN_CLOUD_IDENTITY_URL=your-value --env BITWARDEN_CLOUD_CLIENT_ID=your-value --env BITWARDEN_CLOUD_CLIENT_SECRET=your-value --env BWS_ACCESS_TOKEN=your-value --env BWS_ORG_ID=your-value --env BWS_API_BASE=your-value --env BWS_IDENTITY_URL=your-value --env BITWARDEN_CONFIRM_WRITES=your-value --env BITWARDEN_READ_ONLY=your-value --env LOG_LEVEL=your-value --env BW_MCP_MAX_RESPONSE_BYTES=your-value -- npx -y the-real-bitwarden-mcp

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "the-real-bitwarden": {
      "command": "npx",
      "args": [
        "-y",
        "the-real-bitwarden-mcp"
      ],
      "env": {
        "BITWARDEN_SELFHOST_API_BASE": "your-value",
        "BITWARDEN_SELFHOST_IDENTITY_URL": "your-value",
        "BITWARDEN_SELFHOST_CLIENT_ID": "your-value",
        "BITWARDEN_SELFHOST_CLIENT_SECRET": "your-value",
        "BITWARDEN_CLOUD_API_BASE": "your-value",
        "BITWARDEN_CLOUD_IDENTITY_URL": "your-value",
        "BITWARDEN_CLOUD_CLIENT_ID": "your-value",
        "BITWARDEN_CLOUD_CLIENT_SECRET": "your-value",
        "BWS_ACCESS_TOKEN": "your-value",
        "BWS_ORG_ID": "your-value",
        "BWS_API_BASE": "your-value",
        "BWS_IDENTITY_URL": "your-value",
        "BITWARDEN_CONFIRM_WRITES": "your-value",
        "BITWARDEN_READ_ONLY": "your-value",
        "LOG_LEVEL": "your-value",
        "BW_MCP_MAX_RESPONSE_BYTES": "your-value"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "the-real-bitwarden": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "the-real-bitwarden-mcp"
      ],
      "env": {
        "BITWARDEN_SELFHOST_API_BASE": "your-value",
        "BITWARDEN_SELFHOST_IDENTITY_URL": "your-value",
        "BITWARDEN_SELFHOST_CLIENT_ID": "your-value",
        "BITWARDEN_SELFHOST_CLIENT_SECRET": "your-value",
        "BITWARDEN_CLOUD_API_BASE": "your-value",
        "BITWARDEN_CLOUD_IDENTITY_URL": "your-value",
        "BITWARDEN_CLOUD_CLIENT_ID": "your-value",
        "BITWARDEN_CLOUD_CLIENT_SECRET": "your-value",
        "BWS_ACCESS_TOKEN": "your-value",
        "BWS_ORG_ID": "your-value",
        "BWS_API_BASE": "your-value",
        "BWS_IDENTITY_URL": "your-value",
        "BITWARDEN_CONFIRM_WRITES": "your-value",
        "BITWARDEN_READ_ONLY": "your-value",
        "LOG_LEVEL": "your-value",
        "BW_MCP_MAX_RESPONSE_BYTES": "your-value"
      }
    }
  }
}

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

BITWARDEN_SELFHOST_API_BASE env
Self-hosted instance: API base URL, e.g. https://vault.example.com/api. Configure all four BITWARDEN_SELFHOST_* or all four BITWARDEN_CLOUD_* variables (or both); a partial set is fatal.
BITWARDEN_SELFHOST_IDENTITY_URL env
Self-hosted instance: identity URL, e.g. https://vault.example.com/identity.
BITWARDEN_SELFHOST_CLIENT_ID env
Self-hosted instance: organization Public API client id (organization. ).
BITWARDEN_SELFHOST_CLIENT_SECRET 秘密 env
Self-hosted instance: organization Public API client secret. It can manage members, groups, collections and policies, including creating Owners.
BITWARDEN_CLOUD_API_BASE env
Bitwarden Cloud: API base URL, e.g. https://api.bitwarden.com. Used for license and subscription tools.
BITWARDEN_CLOUD_IDENTITY_URL env
Bitwarden Cloud: identity URL, e.g. https://identity.bitwarden.com.
BITWARDEN_CLOUD_CLIENT_ID env
Bitwarden Cloud: organization Public API client id (organization. ).
BITWARDEN_CLOUD_CLIENT_SECRET 秘密 env
Bitwarden Cloud: organization Public API client secret.
BWS_ACCESS_TOKEN 秘密 env
Optional: Secrets Manager machine account access token; enables the bws_* tools. A malformed token is fatal at startup.
BWS_ORG_ID env
Optional: organization UUID for the Secrets Manager tools, used when a call passes no organizationId.
BWS_API_BASE env
Optional: Secrets Manager API base URL; defaults to BITWARDEN_SELFHOST_API_BASE.
BWS_IDENTITY_URL env
Optional: Secrets Manager identity URL; defaults to BITWARDEN_SELFHOST_IDENTITY_URL.
BITWARDEN_CONFIRM_WRITES env
true: write tools return a preview unless the call carries confirm "YES". The model sets confirm itself, so this is friction, not a security boundary.
BITWARDEN_READ_ONLY env
true: write tools stay listed but refuse to run, and bw_raw_request allows GET only.
LOG_LEVEL env
Log level of the JSON log lines on stderr.
BW_MCP_MAX_RESPONSE_BYTES env
Successful tool output above this many bytes is cut to valid JSON with a responseTruncated marker that says how to narrow or page the query.

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月9日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント mguttmann で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

サイバーセキュリティのほかのサーバーとの比較i

このカテゴリのほかの1004件のうち0%よりスターが多い
このカテゴリのほかの1004件のうち75%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの1004件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Bitwarden Public API and Secrets Manager (unofficial)は安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

入力が必要なもの：BITWARDEN_SELFHOST_CLIENT_SECRET, BITWARDEN_CLOUD_CLIENT_SECRET, BWS_ACCESS_TOKEN

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（0.3.1）がレジストリに届いたのは12 日前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは？

同じカテゴリには：VMware NSX Security, GrindFree Agent Security, SUNGLASSES

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：↓ 週あたりのダウンロードi★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

VMware NSX Security

VMware NSX security: DFW policies and exclusions, groups, tags, Traceflow, IDPS — 22 MCP tools.

作者：vmware-skillsとても新しい↓ 204/週今日更新

パソコンで動く

インストール

GrindFree Agent Security

Pay-per-call agent security: prompt-injection screening, URL safety, tool-call policy (x402)

作者：ronin93今日更新

パソコンで動く

インストール

SUNGLASSES

Input firewall for AI agents: scan text and files before they're read. Local, no network by default.

作者：sunglasses-dev初期↓ 549/週今日更新

パソコンで動く

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Bitwarden MCP Server

Unofficial. This project is not made by, affiliated with or endorsed

by Bitwarden Inc. "Bitwarden" is a trademark of Bitwarden Inc. See

NOTICE.

A local Model Context Protocol (stdio) server that exposes Bitwarden's Public API (organization management) and the Bitwarden Secrets Manager (projects + secrets via the official SDK) as typed tools, read and write.

Intended use: an admin-facing MCP that lets an AI assistant manage members, groups, collections, policies, license seats, and Secrets-Manager data from a single host. Designed for a self-hosted Bitwarden instance, the official Bitwarden Cloud, or both.

Quick links: Architecture · Contributing · Security policy · Releasing · Changelog · Issues

Maintenance status

Maintained on a best-effort basis by one maintainer (@mguttmann) in spare time. The author uses it in production. There is no support contract and no guaranteed response time.
Security fixes take priority over features. Report vulnerabilities privately as described in SECURITY.md, never in a public issue.
Dependency updates come from Dependabot; CI fails when a runtime dependency has a known advisory.
Only the latest minor release gets fixes.
Issues and pull requests are welcome; see CONTRIBUTING.md.

Features

Public API: members, groups, collections, policies, events, organization import, subscription/licensing.
Secrets Manager: projects and secrets via the official @bitwarden/sdk-napi (Zero-Knowledge crypto; cleartext names and values returned directly).
Dual-instance aware: runs against a self-hosted Bitwarden instance, the official cloud, or both. Tools are wired to their instance at registration time so routing mistakes are impossible by accident.
Hand-written tools for common flows (bw_member_list, bw_license_subscription_get, bws_secret_get_value, ...) plus the bw_raw_request escape hatch. With self-host and cloud configured the server lists 54 tools, with or without Secrets Manager; names and required parameters are pinned by tests/tool-contract.test.ts, and parameters are only ever added (optional), never removed or renamed.
No generated tools in the shipped package: the generator for bw_ _ _raw tools exists (npm run generate), but the shipped spec (specs/public-api.spec.json) is empty, so 0 generated tools are registered. See Generated raw tools.
Confirm-gated writes: every write tool returns a request preview unless invoked with confirm: "YES". Default is on. The model sets confirm itself, so this is friction, not a security boundary (see Safety model).
Secret-safe by design: the metadata list never returns values; access tokens are managed in the web vault only.
Token-budget-aware list defaults: list tools (bw_member_list, bw_collection_list, bw_group_list, bw_event_query) return slim projections by default to stay within LLM tool-call token budgets. See List-response shape for the opt-in to full nested responses.

What this MCP can and cannot do

Bitwarden's APIs expose different surfaces with different auth and crypto requirements. This MCP wraps everything that's _cleanly_ reachable. Some operations require Bitwarden's encryption layer (so we use the official SDK); others have no public API at all and need the web vault.

Can: Public API (organization and members)

Uses the Organization Public-API key (organization. / client_credentials / scope api.organization).

List, get, invite, update, remove organization members
Create, update, delete groups; manage group membership
Update collection access per group (read / hide-passwords / manage); omitted fields of update tools keep their current value
Read, set organization policies
Query the event log
Bulk-import groups + members
Read full subscription details (PM seats, SM seats, storage, service-account slots)
Adjust PM seats, PM storage, SM seats, SM service-account slots via the unified PUT /public/organization/subscription endpoint: the tools take a delta, send current + delta as the new total and read it back
Cloud-only: license inspection on the cloud organization

Can: Secrets Manager (via the official Bitwarden SDK)

Uses the Machine-Account access token (BWS_ACCESS_TOKEN), exchanged through @bitwarden/sdk-napi which handles Bitwarden's Zero-Knowledge encryption.

List, get, create, update, delete projects (visible to the configured MA)
List secret metadata, fetch full secret incl. cleartext value, create, update, delete secrets

Cannot: these need a human in the web vault

These are not available to the credentials this server uses (organization API key, machine account access token). The SDK and the bws CLI don't offer them either.

Create, update, delete Machine Accounts
Assign projects to a Machine Account
Create or rotate Machine Account Access Tokens
List all Machine Accounts in the organization (machine accounts and access tokens can only be managed by a logged-in user in the web vault)
Trigger a cloud to self-host license re-sync
Read, grant or revoke a member's Secrets Manager access. Bitwarden's Public API neither returns nor applies accessSecretsManager; bw_member_grant_sm / bw_member_revoke_sm stay registered but always return an error.
Per-user collection access (bw_collection_update rejects a non-empty users list; give members direct access via bw_member_update collections), group accessAll (removed upstream), and filtering events by IP address.

For all of these: use the web vault at https:// /#/sm/{orgId}/.

Requirements

Node.js 22.12 or newer (engines.node >=22.12; CI tests 22, 24 and 26).
A Bitwarden Public-API key (client_id / client_secret) for at least one instance (self-host or cloud).
For Secrets Manager: a Machine-Account access token (from the web vault).

Platform support

This MCP works on any platform with Node.js 22.12 or newer for all Public API features (members, groups, collections, policies, events, license adjustments).

The Secrets Manager features (bws_project_*, bws_secret_*) depend on @bitwarden/sdk-napi (1.0.0, an optional dependency, not MIT licensed), which ships native Rust binaries as optional per-platform packages. The lockfile contains @bitwarden/sdk-napi-darwin-arm64, -darwin-x64, -linux-x64-gnu and -win32-x64-msvc:

OS / Arch	SDK binary	SM tools
macOS Apple Silicon	available	available
macOS Intel	available	available
Linux x86_64 (glibc)	available	available
Windows x86_64	available	available
Linux ARM64 (Raspberry Pi, AWS Graviton)	not available	stubbed
Linux Musl / Alpine	not available	stubbed
Other	not available	stubbed

On unsupported platforms the MCP still starts and all Public-API tools work normally. The bws_project_* and bws_secret_* tools stay registered and return "Secrets Manager SDK not available on this platform" at call time; the load error is logged once at startup as a warn line.

If Bitwarden releases an SDK version with binaries for a new platform, updating the dependency and the lockfile picks it up; no code change is needed.

Installation

The package is the-real-bitwarden-mcp on npm, published from GitHub Actions with provenance. Its bin is bitwarden-mcp. Configuration is the same for every path (see Configuration).

Local MCP clients (npx or npm install)

npx fetches and starts the package; pin a version so an update is a decision, not a side effect of a restart:

npx -y the-real-bitwarden-mcp@<version>

Or install it once and start the bin:

npm install -g the-real-bitwarden-mcp@<version>

bitwarden-mcp

See Connector wiring for client configs.

Gateways and servers (pinned, from npm)

Install a pinned version with a lockfile and start it with node, without npx and without install scripts. Once, in an empty directory:

npm init -y

npm install --save-exact the-real-bitwarden-mcp@ # writes package-lock.json

Commit or keep package.json and package-lock.json. On every deploy:

npm ci --omit=dev --ignore-scripts

node --env-file=/path/to/.env node_modules/the-real-bitwarden-mcp/dist/index.js

The package has no install script and no runtime dependency in devDependencies, so --omit=dev --ignore-scripts is a complete install. The Secrets Manager SDK binary is an optional per-platform package that npm selects by OS and CPU; it needs no script either.

From source

git clone https://github.com/mguttmann/the-real-bitwarden-mcp.git

cd the-real-bitwarden-mcp npm ci # also pulls the platform-specific SDK binary cp .env.example .env

Fill in .env, see "Configuration".

npm run build node --env-file=.env dist/index.js

The SDK binary is an optional dependency: npm ci succeeds even on unsupported platforms (the binary is simply not present, and SM tools return a clear "not available" message).

Generated raw tools

npm run refresh-spec pulls the Swagger document of your self-host instance into specs/public-api.spec.json, and npm run generate builds one bw_ _ _raw tool per operation from it. The shipped spec is empty ({"paths": {}}), so a normal build registers 0 generated tools. Generating tools changes the tool list; if the server runs behind a gateway that pins the tool surface, treat that as a deploy change.

Configuration

All values are environment variables. They come from the process environment (for example node --env-file=.env, or the env block of an MCP client config). When the server is not started with --env-file (or --env-file-if-exists), a .env file in the process working directory is read as well and only fills variables that are not already set; with --env-file it is ignored. At least one instance must be fully configured, otherwise the server refuses to start. A partially configured instance (some but not all four variables) is also fatal, and so is an API base or identity URL that is not an http:// or https:// URL or that has a query or fragment (the error names the variable). Invalid values of the optional numeric and boolean variables fall back to the default.

Variable	Required when	Purpose

冒頭だけを表示しています。続きはリポジトリで読めます

Bitwarden Public API and Secrets Manager (unofficial)

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

自分で入力する値

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

サイバーセキュリティのほかのサーバーとの比較i

よくある質問

代わりの候補

VMware NSX Security

GrindFree Agent Security

SUNGLASSES

作者のREADME

Bitwarden MCP Server

Maintenance status

Features

What this MCP can and cannot do

Can: Public API (organization and members)

Can: Secrets Manager (via the official Bitwarden SDK)

Cannot: these need a human in the web vault

Requirements

Platform support

Installation

Local MCP clients (npx or npm install)

Gateways and servers (pinned, from npm)

From source

Fill in .env, see "Configuration".

Generated raw tools

Configuration