keepassxc-mcp
Provides access to a running, unlocked KeePassXC instance over its browser-integration socket, enabling lookup of logins (username/password/TOTP) by URL, retrieval of TOTP codes, creating or updating logins, generating passwords, browsing and creating groups, checking status/association, and locking the database.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@keepassxc-mcpget the login for https://github.com"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
keepassxc-mcp
MCP server for KeePassXC. It talks to the running, unlocked app over the same browser-integration socket the Chrome/Firefox extension uses. Hermes (or any MCP client) can then look up and save credentials without copy-paste.
It never opens your .kdbx file and never asks for the master password.
What you get
Tool | Does |
| Reachable? Associated? Database hash + KeePassXC version |
| First-time pairing (KeePassXC shows a confirm dialog) |
| Username/password/TOTP for a URL |
| Current TOTP for an entry UUID |
| Create or update a login |
| KeePassXC's generator |
| Folder tree |
| New group/path |
| Lock the open database |
Lookups are by URL, not title — that is a KeePassXC protocol limit, not this server's.
Related MCP server: passwords-mcp
Requirements
KeePassXC 2.7+ with Browser Integration enabled (Settings → Browser Integration)
Database unlocked
Python 3.10+
On this laptop the socket is already present when KeePassXC is running:
/run/user/$UID/org.keepassxc.KeePassXC.BrowserServer
Install
git clone https://github.com/preginald/keepassxc-mcp.git
cd keepassxc-mcp
uv sync --all-extrasOr without uv:
pip install -e '.[dev]'Hermes
hermes mcp add keepassxc \
--command uv \
--args --directory /ABS/PATH/TO/keepassxc-mcp run keepassxc-mcpRestart Hermes after adding. First real lookup pops a KeePassXC dialog named something like keepassxc-mcp — accept it once. The association is stored at ~/.local/share/keepassxc-mcp/identity.json (mode 0600).
Then: "get my GitHub login" or "save this API key in KeePassXC for https://api.example.com".
Other MCP clients
stdio command:
uv --directory /ABS/PATH/TO/keepassxc-mcp run keepassxc-mcpor python -m keepassxc_mcp from an environment that has the package installed.
Environment
Variable | Meaning |
| Unix socket path (otherwise auto-detected) |
| TCP instead of Unix (for a forwarded socket) |
| Identity file path |
| Seconds (default 30; association waits up to 120) |
Security
Secrets travel encrypted (NaCl box) between this process and KeePassXC, then as MCP tool results to the agent.
The agent will see passwords it fetches. Do not attach this server to an untrusted chat.
Writes still go through KeePassXC; it may prompt you.
Identity file is equivalent to a browser-extension pairing key. Keep it 0600 and local.
Tests
uv run pytestTests use an in-process fake KeePassXC. They never touch a real vault.
Protocol
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for mandates, delegation, policy-gated execution, credential grants, and audit.
Browser MCP for logged-in tasks. Uses your Chrome — credentials stay local. Zero-token replay.
Read and write shared BitsWeave context, projects, tasks, and work sessions through MCP.
Manage your KeepMySubs subscriptions, spend, renewals, and bills from any MCP client.
Related MCP Servers
- AlicenseBqualityCmaintenanceMCP server for secure credential management, browser-based login automation, and TOTP/2FA auto-solving. Encrypts credentials with AES-256-GCM and automates login flows via Playwright.322MIT
- AlicenseAqualityAmaintenanceMCP server for the Nextcloud Passwords app, enabling reading and managing password entries (list, search, create, update, delete) with strong security guarantees.14MIT
- AlicenseAqualityBmaintenanceProvides local, secure access to Enpass password vaults via MCP. Enables unlocking vaults, listing entries, retrieving passwords, TOTP codes, and attachments, with optional write support.1030 npm3MIT
- AlicenseNot gradedqualityAmaintenanceMCP server for accessing Vaultwarden servers with multi-account support.MIT