Secret Handoff
Let a coding agent use temporary credentials without the values entering the chat
- Pricing
- Free
- Platforms
- macOS, Windows, Linux
- Runs
- Locally
- Version
- 0.0.2
- Listing updated
- 2 days ago
About Secret Handoff
Secret Handoff is a free MCP server for security. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add secrethandoff -- npx -y https://github.com/geland/secrethandoff-integrations/releases/download/mcpb-v0.0.2/secrethandoff-multiplatform.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"secrethandoff": {
"command": "npx",
"args": [
"-y",
"https://github.com/geland/secrethandoff-integrations/releases/download/mcpb-v0.0.2/secrethandoff-multiplatform.mcpb"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"secrethandoff": {
"command": "npx",
"args": [
"-y",
"https://github.com/geland/secrethandoff-integrations/releases/download/mcpb-v0.0.2/secrethandoff-multiplatform.mcpb"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"secrethandoff": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/geland/secrethandoff-integrations/releases/download/mcpb-v0.0.2/secrethandoff-multiplatform.mcpb"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"secrethandoff": {
"command": "npx",
"args": [
"-y",
"https://github.com/geland/secrethandoff-integrations/releases/download/mcpb-v0.0.2/secrethandoff-multiplatform.mcpb"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"secrethandoff": {
"command": "npx",
"args": [
"-y",
"https://github.com/geland/secrethandoff-integrations/releases/download/mcpb-v0.0.2/secrethandoff-multiplatform.mcpb"
]
}
}
}What it does
- 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
Pricing
Free
Prices change. Check secrethandoff.com before you buy.
Secret Handoff 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 to Secret Handoff

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools