# Lockbox

> Lockbox is an open-source MCP server for security. Stdio MCP server that lets agents store API keys without ever seeing the values. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux, self-hosted
- **Repository:** https://github.com/rosostolato/lockbox-mcp
- **MCP Registry name:** io.github.rosostolato/lockbox-mcp
- **Categories:** [security](https://ai-powered.com/categories/security), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add lockbox-mcp -- npx -y lockbox-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "lockbox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "lockbox-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "lockbox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "lockbox-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "lockbox-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "lockbox-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "lockbox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "lockbox-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "lockbox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "lockbox-mcp"
      ]
    }
  }
}
```

## Tools

- `secret_status`: Lets the agent poll the status of a pending secret request.

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

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/lockbox-3
