Lockbox
Stdio MCP server that lets agents store API keys without ever seeing the values
- Pricing
- Open source
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 0.1.1
- Listing updated
- today
Similar MCP servers
About Lockbox
Lockbox is an open-source MCP server for security. It runs locally on your machine and is started by your AI client.
The agent only describes where a secret should go: a file, a command such as gcloud, or an HTTPS request with a {{secret}} placeholder. The tool schema has no field that could carry a value, and arguments are screened for credential-shaped strings. You then paste the key into a local window on 127.0.0.1, which shows the destination in one line, flags anything unusual and checks the key format.
Once you confirm, Lockbox sends the value to the destination and tells the agent only that it was stored, along with a reference. The authorization link is not given to the agent unless you explicitly enable that. The README is explicit about limits: it does not make an agent trustworthy or stop prompt injection.
It runs on Node 20+ and depends on a single package, zod, with the MCP protocol implemented in-tree.
Install
Run in a terminal
claude mcp add lockbox-mcp -- npx -y lockbox-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"lockbox-mcp": {
"command": "npx",
"args": [
"-y",
"lockbox-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"lockbox-mcp": {
"command": "npx",
"args": [
"-y",
"lockbox-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"lockbox-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"lockbox-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"lockbox-mcp": {
"command": "npx",
"args": [
"-y",
"lockbox-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"lockbox-mcp": {
"command": "npx",
"args": [
"-y",
"lockbox-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
LOCKBOX_ENV_ALLOWED_ROOTSFolders that file destinations may write inside. Defaults to the current directory.
Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- secret_status
- Lets the agent poll the status of a pending secret request.
What it does
- Value-free tool schema
- No property exists that could carry a credential, and unknown properties are rejected.
- Local approval window
- You see and approve the destination in a loopback-only page before anything is sent.
- Format and environment check
- Warns when, for example, a test key is headed to production.
- File and command destinations
- Writes to allowed folders or pipes the secret to tools such as gcloud, vercel or gh.
- Saved destinations
- The agent can reuse a destination you saved earlier.
- Audit output
- Structured audit JSON goes to stderr.
Good for
- Put a Stripe test key into .env without pasting it in chat
- Add a secret to Google Secret Manager through gcloud
- Keep credentials out of prompts, logs and agent memory
- Restrict where an agent may write secrets using allowed roots
Pricing
Open source
Lockbox FAQ
Does the agent ever see the key?
No. It receives a status and a reference such as the file and variable name.
How do I install it?
Run claude mcp add lockbox with npx -y lockbox-mcp serve, and set LOCKBOX_ENV_ALLOWED_ROOTS to your project folder.
What does it not protect against?
It does not guarantee the agent picked the right destination, prevent prompt injection, or protect a compromised machine.
What are the requirements?
Node.js 20 or newer and an MCP client that can start stdio servers.
Is Lockbox free?
Yes. Lockbox is open source, so you can use and self-host it for free.
How do I add Lockbox to Claude Code?
Run this command in your terminal: claude mcp add lockbox-mcp -- npx -y lockbox-mcp
What are the best alternatives to Lockbox?
The closest alternatives to Lockbox are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


