Skip to content
MCP server

Secret Handoff

Let a coding agent use temporary credentials without the values entering the chat

Runs locallyStatus and history
Install
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.mcpb

Add 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"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

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"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools