rbw-mcp

Model Context Protocol (MCP) server that enables interaction with the Bitwarden password manager vault via the rbw (Rust Bitwarden) command-line interface. The server allows AI models to securely communicate with a user's Bitwarden vault through defined tool interfaces.

Prerequisites

• Node.js 22

• rbw (Rust Bitwarden CLI) installed and configured.

Installation

Option One: Configuration in your AI app

Open up your application configuration, e.g. for Claude Desktop:

{
  "mcpServers": {
    "rbw": {
      "command": "npx",
      "args": ["-y", "rbw-mcp"]
    }
  }
}

Option Two: Local checkout

Requires that this repository be checked out locally. Once that's done:

npm install
npm run build

Setup

1. Install rbw: Follow the instructions for your platform on the official rbw repository. For example, on Debian/Ubuntu:

   sudo apt-get update
   sudo apt-get install rbw

2. Configure rbw: Configure rbw to connect to your Bitwarden account.

   rbw config

3. Unlock your vault: Before running the MCP server, you must unlock your vault. This starts the rbw-agent and allows subsequent commands to run without prompting for a password.

   rbw unlock

   The server will check if the vault is unlocked on startup.

Testing

Running unit tests

The project includes Jest unit tests.

# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Run tests with coverage
npm test -- --coverage

Inspection and development

MCP Inspector

Use the MCP Inspector to test the server interactively:

# Start the inspector
npm run inspect

This will:

1. Start the MCP server

2. Launch the inspector UI in your browser

3. Allow you to test all available tools interactively

Available tools

The server provides the following rbw CLI tools:

Security considerations

• Use rbw-agent: It is highly recommended to use rbw with its agent to handle the master password securely.

• Validate all inputs: All tool inputs are strictly validated using Zod schemas.

Troubleshooting

Common issues

1. "Vault is locked" error on startup

   • Run rbw unlock in your terminal before starting the server.

2. rbw command not found

   • Ensure that rbw is installed and that its location is in your system's PATH.

3. Tests failing

   • Ensure all development dependencies are installed with npm install.