# bitwarden-mcp

MCP server for Bitwarden/Vaultwarden vault operations.

Source: [`@bitwarden/mcp-server`](https://npm.im/@bitwarden/mcp-server)

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `BW_API_BASE_URL` | Yes | Self-hosted Vaultwarden API URL (e.g. `https://vault.corentic.eu/api`) |
| `BW_IDENTITY_URL` | Yes | Self-hosted Vaultwarden identity URL (e.g. `https://vault.corentic.eu/identity`) |
| `BW_CLIENT_ID` | Yes | Bitwarden client ID (from Admin Panel → API Keys) |
| `BW_CLIENT_SECRET` | Yes | Bitwarden client secret |
| `BW_PASSWORD` | Yes | Vault master password |
| `BW_SESSION` | No | Session key (optional, obtained via `bw unlock --raw`) |

## Usage

```bash
docker run -d \
  --name bitwarden-mcp \
  -p 8112:8112 \
  -e BW_API_BASE_URL=https://vault.corentic.eu/api \
  -e BW_IDENTITY_URL=https://vault.corentic.eu/identity \
  -e BW_CLIENT_ID=user_xxx \
  -e BW_CLIENT_SECRET=your_secret \
  -e BW_PASSWORD=master_password \
  forgejo.corentic.eu/corentic/mcp-fleet-bitwarden:latest
```

## Tools

- `list_folders`, `create_folder` — Folder management
- `list_items`, `search_items` — Item listing/search
- `get_item` — Get item details
- `create_item`, `edit_item`, `delete_item` — CRUD operations