Bitwarden Public API and Secrets Manager (unofficial)

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

de mguttmannversión 0.3.1i★ –iSe ejecuta en tu computadora

Nombre en el registroio.github.mguttmann/the-real-bitwarden-mcp

Instalar

Resumen

Descripción del creador (original en inglés)

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

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
Nuestras revisiones básicasi1 de 1 superadasRevisado con información pública; el código aún no se ha escaneado
UsoiMuy nuevo↓ 139/sem · ★ –

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

Conexión: Se ejecuta en tu computadora
Transporte: stdio
Categoría: Ciberseguridad
Debes completar: BITWARDEN_SELFHOST_CLIENT_SECRET, BITWARDEN_CLOUD_CLIENT_SECRET, BWS_ACCESS_TOKEN

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

Revisiones básicas: 1 de 1 superadas
Se ejecuta en tu computadora con los permisos de tu usuario (archivos, red, apps).
Debes completar tú: 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

Los valores marcados como secretos son llaves de tu cuenta. Nunca los compartas ni los pegues en un chat.

Necesitas

npmNode.js instalado (para el comando npx)

¿Qué app usas?

ClaudeClaude CodeCursorVS CodeChatGPT

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en 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"
      }
    }
  }
}

Ejecuta esto en tu terminal

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

Completa los valores vacíos antes de ejecutarlo.

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.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"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

{
  "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"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Valores que debes completar

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 secreto 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 secreto env
Bitwarden Cloud: organization Public API client secret.
BWS_ACCESS_TOKEN secreto 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.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 9 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub mguttmann, dueña del repo
… Aún sin revisar
Sigue en mantenimiento
Todavía no hemos leído este repo en GitHub
… Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Comparado con otros en Ciberseguridadi

Más estrellas que el 0% de los otros 1003 servidores de esta categoría
Publicado en el registro más recientemente que el 75% de los otros 1003 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 1003 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Bitwarden Public API and Secrets Manager (unofficial)?

Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: BITWARDEN_SELFHOST_CLIENT_SECRET, BITWARDEN_CLOUD_CLIENT_SECRET, BWS_ACCESS_TOKEN

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez –, y la última versión (0.3.1) llegó al registro hace 12 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: SUNGLASSES, KillerSkills, Draugr

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

SUNGLASSES

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

de sunglasses-devInicial↓ 549/semActualizado hoy

Se ejecuta en tu computadora

Instalar

KillerSkills

Security verdicts for agent skills and MCP servers, from sandbox runs, before you install them.

de cyligence-karimEn crecimiento↓ 3,1 mil/semActualizado hoy

Se ejecuta en tu computadora

Instalar

Draugr

Security scanning for AI agents: SAST, SCA, secrets, IaC, DAST, ranked by real risk.

de draugr-devMuy nuevoActualizado hoy

Se ejecuta en tu computadora✓ draugr.dev

Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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

Solo se muestra el principio; lee el resto en el repo

Bitwarden Public API and Secrets Manager (unofficial)

Resumen

Los tres pilares de PopNx MCP

Qué puedes hacer con él

Instalación

Antes de instalar

Valores que debes completar

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Comparado con otros en Ciberseguridadi

Preguntas frecuentes

Alternativas

SUNGLASSES

KillerSkills

Draugr

README del creador

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