# Secret Handoff

> Secret Handoff is a free MCP server for security. Let a coding agent use temporary credentials without the values entering the chat. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** macOS, Windows, Linux, CLI
- **Website:** https://secrethandoff.com
- **Repository:** https://github.com/geland/secrethandoff-integrations
- **MCP Registry name:** io.github.geland/secrethandoff
- **Categories:** security, developer tools
- **Listing updated:** 2026-11-15

## About

The secret is typed into a private browser page opened by a local tool, never into the conversation. The agent receives only a reference and redacted results, while the tool keeps the value in memory and attaches it to requests you approve, down to the API host, method and path. Closing the tool clears everything, and you can ask the agent to forget a secret at any time. There is no vault and no Secret Handoff account.

The site is candid about boundaries. The approved API receives the credential and may keep it, so forgetting it locally does not revoke it at the provider. A filled secret has no automatic timeout, and the tool is not a hard barrier against other processes running as you. run_with_secret needs browser approval by default, and an approved command receives the value and can leak it.

It runs locally over stdio and needs Node 22 or newer; the registry entry points at a multi-platform MCPB bundle. The repository publishes Claude Code and Codex plugins with detection hooks that can block some accidental pastes. Phone and remote handoffs are paused pending an independent protocol review.

## Features

- **Secrets stay out of chat:** The agent gets a reference and redacted responses, not the value.
- **Scoped approval:** You approve the API host, method and path before a secret is used.
- **In-memory only:** Secrets live in the tool process until forgotten or the tool closes.
- **Command approval:** run_with_secret requires browser approval by default.
- **Paste detection hooks:** Claude hooks can block some accidental pastes before they reach the model.
- **One-time links:** Share a secret with a person through a link they can open once.

## Good for

- Give an agent a temporary API token for one task
- Confirm a single report-export API call before it runs
- Hand a one-time code to an agent without pasting it
- Share a password with a colleague through a one-time link

## Install

### Claude Code (Terminal)

```sh
claude mcp add secrethandoff -- npx -y https://github.com/geland/secrethandoff-integrations/releases/download/mcpb-v0.0.2/secrethandoff-multiplatform.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "secrethandoff": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/geland/secrethandoff-integrations/releases/download/mcpb-v0.0.2/secrethandoff-multiplatform.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "secrethandoff": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/geland/secrethandoff-integrations/releases/download/mcpb-v0.0.2/secrethandoff-multiplatform.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "secrethandoff": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/geland/secrethandoff-integrations/releases/download/mcpb-v0.0.2/secrethandoff-multiplatform.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "secrethandoff": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/geland/secrethandoff-integrations/releases/download/mcpb-v0.0.2/secrethandoff-multiplatform.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "secrethandoff": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/geland/secrethandoff-integrations/releases/download/mcpb-v0.0.2/secrethandoff-multiplatform.mcpb"
      ]
    }
  }
}
```

## FAQ

### Does it need an account or a vault?

No. The README says there is no vault to configure and no Secret Handoff account.

### Does forgetting a secret revoke it?

No. The approved API may retain it, so revoke it at the provider.

### Can I hand off from my phone?

Not yet. Phone and remote handoffs are paused for an independent protocol review; local handoffs work.

### What does it require?

Node 22 or newer, and the Secret Handoff CLI for the Claude Code and Codex plugins.

### Is Secret Handoff free?

Yes. Secret Handoff is free to use.

### How do I add Secret Handoff to Claude Code?

Run this command in your terminal: claude mcp add secrethandoff -- npx -y https://github.com/geland/secrethandoff-integrations/releases/download/mcpb-v0.0.2/secrethandoff-multiplatform.mcpb

### What are the best alternatives to Secret Handoff?

The closest alternatives to Secret Handoff are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [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.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/secret-handoff
