# KeyZula

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: KeyZula
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/KeyZula/mcp-server
- Updated: 2026-11-05
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/keyzula

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `KEYZULA_SERVICE_TOKEN`, `KEYZULA_MCP_ALLOW_REVEAL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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/cli
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add keyzula --env KEYZULA_SERVICE_TOKEN=<KEYZULA_SERVICE_TOKEN> --env KEYZULA_MCP_ALLOW_REVEAL=<KEYZULA_MCP_ALLOW_REVEAL> -- npx -y @keyzula/cli
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e KEYZULA_SERVICE_TOKEN=<KEYZULA_SERVICE_TOKEN> -e KEYZULA_MCP_ALLOW_REVEAL=<KEYZULA_MCP_ALLOW_REVEAL> keyzula npx -y @keyzula/cli
```
Replace <…> with your own values

## When to use it
- 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
- Deploy the project using the Cloudflare token in KeyZula.
- Run the database migrations with the staging password from KeyZula.
- Create this project's `.env` file using my KeyZula entries.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
