Skip to main content
Glama

handoff-mcp

handoff-mcp header

MCP server that acts as a shared memory hub across multiple LLMs (Claude, Gemini, Copilot, Codex). Any agent entering a project immediately understands its architecture, patterns, and decisions — and can pick up exactly where the previous LLM left off.

Tools

Tool

Description

create_or_get_project

Initialize or retrieve a project

save_architecture

Save architecture overview and tech stack

get_project_summary

Full project overview — perfect as first call

save_context_snapshot

Save working state before handing off

get_context_snapshot

Retrieve what the previous LLM was doing

list_sessions

List all saved sessions

save_code_pattern

Save reusable code patterns (JWT, FCM, etc.)

get_code_patterns

Retrieve patterns by category/language

save_architectural_decision

Save an ADR (why a decision was made)

get_decisions

Retrieve architectural decisions

search_context

Search across patterns, decisions, and snapshots

Related MCP server: ai-cortex

Setup

No install needed. Just add the config below to your tool and it runs automatically via bunx.

Requires Bun installed on your machine. Install it with: curl -fsSL https://bun.sh/install | bash

Claude Desktop

File: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "handoff-mcp": {
      "command": "bunx",
      "args": ["handoff-mcp"]
    }
  }
}

Claude Code

claude mcp add handoff-mcp bunx handoff-mcp

Gemini CLI

File: ~/.gemini/settings.json

{
  "mcpServers": {
    "handoff-mcp": {
      "command": "bunx",
      "args": ["handoff-mcp"]
    }
  }
}

GitHub Copilot (VS Code)

File: .vscode/mcp.json in your workspace

{
  "servers": {
    "handoff-mcp": {
      "type": "stdio",
      "command": "bunx",
      "args": ["handoff-mcp"]
    }
  }
}

OpenAI Codex CLI

File: ~/.codex/config.yaml

mcpServers:
  handoff-mcp:
    command: bunx
    args:
      - handoff-mcp

By default each tool creates its own context.db in the working directory. To share the same memory across all LLMs, point them all to the same file:

{
  "mcpServers": {
    "handoff-mcp": {
      "command": "bunx",
      "args": ["handoff-mcp"],
      "env": { "DB_PATH": "/Users/you/handoff.db" }
    }
  }
}

Flow

Claude works on the project
→ create_or_get_project("my-app")
→ save_architecture({ description: "React Native + Spring Boot" })

Claude runs low on tokens
→ save_context_snapshot({
    llmModel: "claude-opus-4",
    taskDescription: "Implementing push notifications",
    recentChanges: "FCM handler done",
    nextSteps: "Wire up Foreground Service, test Android 16"
  })

Gemini takes over
→ get_project_summary("my-app")      # full context in one call
→ get_context_snapshot("my-app")     # picks up exactly where Claude stopped
→ continues...

Dev

git clone https://github.com/Juan-Severiano/handoff-mcp
cd handoff-mcp
bun install
bun run dev      # watch mode
bun run inspect  # MCP Inspector
bun run build    # compile to dist/
A
license - permissive license
Not graded
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides persistent context synchronization and memory management for AI agents across sessions and projects, including file indexing, bug tracking, spatial navigation, and agent-to-agent handoff coordination.
    11
    3
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Provides durable project context for coding agents, including project maps, session history, and explicit memories, all stored locally.
    74
    6
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Gives AI agents persistent memory, handoffs, and shared context across sessions, enabling seamless continuity and multi-agent collaboration.
    66
    68
    Inno Setup

View all related MCP servers

Related MCP Connectors

  • Durable agent-to-agent handoffs and shared scratchpad for multi-agent workflows.

  • Persistent docs and memory for AI agents — read, write, organize & search a shared workspace.

  • Shared, governed long-term memory for AI agents across tools and sessions via MCP and REST.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Juan-Severiano/handoff-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server