claude-memory-bridge

MCP server that bridges Claude Code's file-based memory system to Claude Desktop, enabling two-way context sharing between clients.

What it does

Claude Code stores memories as markdown files with YAML frontmatter in ~/.claude/projects/. This server exposes those memories — plus an inbox system and project status dashboard — as MCP tools that Claude Desktop can call.

Memory reading

Discover projects, list memories by type, and search with weighted relevance scoring across all projects or filtered to one.

Inbox

A cross-client messaging system. Claude Desktop creates inbox items (TODOs and notes) that Claude Code surfaces on session start via a shell hook. Items have status tracking (pending → in_progress → completed | dismissed), priority levels, and tags.

Memory writing

Claude Desktop can write memories in Claude Code's native format — markdown with YAML frontmatter — and automatically update the project's MEMORY.md index.

Project status

Aggregates a live snapshot of any project: memory counts by type, pending inbox items, current git branch, active branches, and recent commits.

Setup

Prerequisites

• Node.js >= 20
• Claude Code (memories in ~/.claude/projects/)

Install

npm install
npm run build

Configure Claude Desktop

Add to your Claude Desktop MCP config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "claude-memory-bridge": {
      "command": "node",
      "args": ["/absolute/path/to/claude-memory-bridge/dist/index.js"]
    }
  }
}

Inbox session hook (optional)

To have Claude Code surface pending inbox items on session start, add a hook to your Claude Code settings (~/.claude/settings.json):

{
  "hooks": {
    "SessionStart": [
      {
        "type": "command",
        "command": "/absolute/path/to/claude-memory-bridge/scripts/check-inbox.sh"
      }
    ]
  }
}

Tools

Resources

How it works

Claude Code encodes project paths as directory slugs under ~/.claude/projects/ — for example, /Users/kelly/code/my-project becomes -Users-kelly-code-my-project. The server resolves these slugs back to real filesystem paths by walking the directory tree, handling ambiguities where both / and . encode to -.

Memories live in ~/.claude/projects/<slug>/memory/*.md. Inbox items live in ~/.claude/projects/<slug>/inbox/*.md. Both use YAML frontmatter for structured metadata.

License

MIT