MCPs/bitwarden/README.md

37 lines
No EOL
1.3 KiB
Markdown

# 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