KeyZula — Claude Code MCP server for vault secrets
This MCP server for Claude Code gives commands access to passwords and API keys in KeyZula without exposing their values to the assistant. It can also insert vault references into files.
MIT updated 2026-11-05
claude mcp add --env KEYZULA_SERVICE_TOKEN=<KEYZULA_SERVICE_TOKEN> --env KEYZULA_MCP_ALLOW_REVEAL=<KEYZULA_MCP_ALLOW_REVEAL> --transport stdio keyzula -- npx -y @keyzula/cliWhat KeyZula does
KeyZula searches vault entries and passes secrets to programs through kz:// references. The assistant gets entry names and references, not the secret values. It can run a command with secrets in its environment or write a file that only you can read.
You need a free KeyZula account and its CLI, signed in and unlocked once in a terminal. Start the agent with keyzula ssh-agent --daemon; the server reads from that agent. read_secret is off by default. When enabled, each request needs approval in a window on your computer. The server runs on macOS, Linux and Windows.
What it helps with
- run a command with a vault password
- populate a project file with KeyZula secrets
- find a vault entry by name, site or username
- generate a password or passphrase
Example prompts for the agent
- Deploy the project using the Cloudflare token in KeyZula.
- Run the database migrations with the staging password from KeyZula.
- Create this project's
.envfile using my KeyZula entries.
How to install KeyZula
Platform CLI
claude mcp add --env KEYZULA_SERVICE_TOKEN=<KEYZULA_SERVICE_TOKEN> --env KEYZULA_MCP_ALLOW_REVEAL=<KEYZULA_MCP_ALLOW_REVEAL> --transport stdio keyzula -- npx -y @keyzula/cliReplace <…> with your own values
Platform CLI
codex mcp add keyzula --env KEYZULA_SERVICE_TOKEN=<KEYZULA_SERVICE_TOKEN> --env KEYZULA_MCP_ALLOW_REVEAL=<KEYZULA_MCP_ALLOW_REVEAL> -- npx -y @keyzula/cliReplace <…> with your own values
Config file
{
"mcpServers": {
"keyzula": {
"command": "npx",
"args": [
"-y",
"@keyzula/cli"
],
"env": {
"KEYZULA_SERVICE_TOKEN": "<KEYZULA_SERVICE_TOKEN>",
"KEYZULA_MCP_ALLOW_REVEAL": "<KEYZULA_MCP_ALLOW_REVEAL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"keyzula": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@keyzula/cli"
],
"env": {
"KEYZULA_SERVICE_TOKEN": "<KEYZULA_SERVICE_TOKEN>",
"KEYZULA_MCP_ALLOW_REVEAL": "<KEYZULA_MCP_ALLOW_REVEAL>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e KEYZULA_SERVICE_TOKEN=<KEYZULA_SERVICE_TOKEN> -e KEYZULA_MCP_ALLOW_REVEAL=<KEYZULA_MCP_ALLOW_REVEAL> keyzula npx -y @keyzula/cliReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about KeyZula
How do I install KeyZula in Claude Code?
Install the CLI with npm i -g @keyzula/cli (or brew install keyzula/tap/keyzula), then run keyzula login and keyzula ssh-agent --daemon. Add the server with claude mcp add keyzula -e KEYZULA_SERVICE_TOKEN=<KEYZULA_SERVICE_TOKEN> -- npx -y @keyzula/cli. This command uses an organization service token.
What does KeyZula do?
It lets an assistant search vault entries and run commands with secrets in their environment. The program receives the values; the assistant sees references and command output.
What does KeyZula need to run?
You need a free KeyZula account and the CLI, signed in and unlocked in a terminal. The server reads secrets through the local KeyZula agent.