Skip to main content
Glama
AIWerk

@aiwerk/mcp-server-vault

by AIWerk

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
DRY_RUNNoSet 1 to log write operations without executing them0
READ_ONLYNoSet 1 to block all write operations (Send creation and save)0
VAULT_API_BASEYesBase URL of your Bitwarden/Vaultwarden instance (no trailing slash)
VAULT_CLIENT_IDYesPersonal API key client_id (e.g. user.abc-def-1234)
VAULT_CLIENT_SECRETYesPersonal API key client_secret
VAULT_API_TIMEOUT_MSNoHTTP timeout in milliseconds15000
VAULT_MASTER_PASSWORDYesVault master password (used for E2E decryption key derivation)
VAULT_EXPOSED_COLLECTIONNoName of the collection visible to agentsmcp-exposed
VAULT_AGENT_CREATED_COLLECTIONNoName of the collection for agent-created secretsmcp-agent-created

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_vault_itemsA

List vault items from the mcp-exposed and mcp-agent-created collections. Returns metadata only — secret values are NEVER included. Use reveal_secret_via_send to obtain the actual value through a secure Bitwarden Send URL.

get_vault_metadataA

Get full metadata for a named vault item. Returns name, type, username (for login items), URIs, custom fields, scope, expiry. Password, TOTP seed, and api-key values are NEVER returned — use reveal_secret_via_send or get_totp_code instead.

reveal_secret_via_sendA

Reveal a vault secret through a Bitwarden Send — an E2E-encrypted one-time URL. Creates a temporary Send with a configurable TTL and max-views limit. The secret value is encrypted client-side; only the URL fragment (never sent to server) can decrypt it. Blocked when READ_ONLY=1. Logs to DRY_RUN without creating a real Send when DRY_RUN=1.

get_totp_codeA

Get the current TOTP code for a vault login item with TOTP configured. Returns the 6-digit code, the remaining seconds in the current period, and the algorithm. Use the remaining_seconds field to decide whether to use the code immediately or wait for a fresh period.

save_generated_secretA

Save an agent-generated secret into the mcp-agent-created collection. CREATE-only — cannot overwrite an existing item (name collision returns an error). The secret is E2E-encrypted with the vault org key before transmission. Sets mcp-created-by, mcp-created-at, mcp-expires-at, and mcp-used-in custom fields automatically. Blocked when READ_ONLY=1. Logs to DRY_RUN without creating a real cipher when DRY_RUN=1.

save_login_itemA

Save login credentials (username, password, URL, optional TOTP seed) as a Vaultwarden login item in the mcp-agent-created collection. Use this instead of save_generated_secret when the credential is a sign-in (username + password), so it surfaces as a real login item with get_totp_code support. CREATE-only — cannot overwrite an existing item (name collision returns an error). At least one of username or password is required. All fields are E2E-encrypted with the vault org key before transmission. Sets mcp-created-by, mcp-created-at, mcp-expires-at, and mcp-used-in custom fields automatically. Blocked when READ_ONLY=1. Logs to DRY_RUN without creating a real cipher when DRY_RUN=1.

health_checkA

Check connectivity and configuration of the Bitwarden/Vaultwarden vault. Authenticates, syncs, and reports: auth status, API version, collection visibility, item counts, latency. Run this first after a new install or after rotating credentials.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/AIWerk/mcp-server-vault'

If you have feedback or need assistance with the MCP directory API, please join our Discord server