Skip to main content
Glama
acheron-mcp-server
by timmx7

Acheron

Shared persistent memory across Claude Chat, Code, and Cowork.

  ┌───────────┐     ┌───────────┐     ┌───────────┐
  │   Chat    │     │   Code    │     │  Cowork   │
  └─────┬─────┘     └─────┬─────┘     └─────┬─────┘
        │                 │                  │
        └────────┬────────┴────────┬─────────┘
                 │                 │
           ┌─────▼─────────────────▼─────┐
           │        Acheron MCP          │
           │  ┌───────────────────────┐  │
           │  │  ~/.acheron/bridge.db │  │
           │  └───────────────────────┘  │
           └─────────────────────────────┘
                  Local · No cloud

Save a decision in Chat. Retrieve it in Cowork. Search for it from Code. All local, all offline, zero configuration.

Install

This connects Acheron to all surfaces — Chat, Code, Cowork, and Dispatch. This is the recommended setup for full cross-surface bridging.

Open Claude Desktop → Settings → Developer → Edit Config, then add:

{
  "mcpServers": {
    "acheron": {
      "command": "npx",
      "args": ["-y", "acheron-mcp-server"]
    }
  }
}

Restart Claude Desktop.

Claude Code only

If you only need Acheron in Claude Code (terminal / IDE):

claude mcp add acheron -- npx -y acheron-mcp-server

Requires Node.js 20+. Native build tools may be needed for better-sqlite3 (details).

Related MCP server: mcp-openmemory

Usage

Just talk naturally. Acheron's tool descriptions are written so Claude uses them automatically.

Save context — say "remember this", "save this decision", "note that we chose X":

"Remember: we're using Next.js App Router for the acme-site project."

Search context — say "what did I decide about...", "find my notes on...":

"What did we decide about the authentication approach?"

Browse context — say "show me my preferences", "list all decisions for this project":

"Show me everything saved for acme-site."

How it works

Acheron is an MCP server. It stores context in a local SQLite database (~/.acheron/bridge.db) with full-text search. No cloud, no network calls, no telemetry. Data never leaves your machine.

Six tools, all prefixed bridge_:

Tool

Purpose

bridge_save_context

Remember decisions, preferences, insights, notes

bridge_get_context

Retrieve full details of a saved context

bridge_search_context

Full-text search across all saved contexts

bridge_list_contexts

Browse and filter by project, surface, type, tags

bridge_delete_context

Forget a saved context

bridge_status

Overview of what's stored

Troubleshooting

better-sqlite3 install fails? You need native build tools:

Database issues? Delete ~/.acheron/bridge.db — Acheron recreates it on next start.

License

MIT

Available Tools

6 tools
bridge_delete_contextForget / Delete ContextA
DestructiveIdempotent

Permanently delete a saved context. Use when the user says "forget this", "delete that", "remove that note", "I don't need that anymore", or "that's outdated, remove it". Requires the context ID — use search or list first to find it.

Inputs: id (required).

bridge_get_contextRecall Saved ContextA
Read-onlyIdempotent

Retrieve the full details of a previously saved context by its ID. Use this after finding a context via search or list, when the user wants to see the complete content of a specific saved memory. Typically used as a follow-up: "show me that decision", "give me the full details on that one".

Inputs: id (required), response_format.

bridge_list_contextsBrowse Saved ContextsA
Read-onlyIdempotent

Browse and filter all saved contexts. Use when the user asks "what have I saved?", "show me my decisions", "what do I have for this project?", "list my preferences", "what did we do recently?", "show everything tagged with...", or "what happened in Cowork?". Unlike search (keyword-based), this tool browses by category — filter by project, surface, type, tags, or date. Returns newest entries first.

Inputs: tags, type, limit, since, +4 more.

bridge_save_contextRemember / Save ContextA

Remember something for later. Use this when the user says things like "remember this", "save this", "note this", "keep this for later", "don't forget", or when an important decision, preference, or insight comes up that should persist across conversations. This saves context that will be available in ALL Claude surfaces (Chat, Code, Cowork) — even in future sessions. Use proactively when you recognize something worth remembering: a decision made, a user preference expressed, a lesson learned, a key file identified, or a workflow established.

Inputs: type (required), content (required), source_surface (required), tags, +2 more.

bridge_search_contextSearch Saved KnowledgeA
Read-onlyIdempotent

Search through everything that has been saved across conversations. Use when the user asks "what did I decide about...", "what do we know about...", "did I save anything about...", "find my notes on...", "what was that thing about...", or any question that might be answered by previously saved context. Also use proactively when the user asks a question that saved context might answer — check before saying "I don't have that information". Searches across all surfaces (Chat, Code, Cowork) and all projects.

Inputs: query (required), type, limit, offset, +3 more.

bridge_statusMemory OverviewA
Read-onlyIdempotent

Show a summary of all saved knowledge: how many contexts are stored, broken down by surface (Chat/Code/Cowork) and type (decisions, preferences, insights, etc.), database size, and date range. Use when the user asks "how much have I saved?", "give me an overview", "what's in my memory?", or "how big is my context database?".

Inputs: response_format.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool targets a distinct action (save, get, list, search, delete, status) on contexts with no overlap. The descriptions clearly differentiate when to use each.

    Naming Consistency5/5

    All tool names follow a consistent pattern: bridge_verb_context (e.g., bridge_save_context, bridge_list_contexts). The verbs are clear and uniform.

    Tool Count5/5

    Six tools cover the essential operations for a context management system (CRUD plus search and overview) without being excessive or sparse.

    Completeness4/5

    The tool set provides create, read, list/ browse, search, delete, and status. An update operation is missing, but contexts may be intended as immutable entries, making the set largely complete.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Persistent memory for Claude Code. Automatically indexes every conversation and provides production-grade hybrid search (BM25 + vectors + reranker) via MCP tools. 100% local, zero config, zero API keys, zero invoice.
      16
      42 npm
      8
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables Claude to remember conversations and learn over time by storing and recalling messages, memory abstracts, and recent history using a local SQLite database.
      4
      41 npm
      70
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides persistent, searchable memory for Claude Code using local SQLite, semantic embeddings, and full-text search, enabling Claude to recall and retrieve context across sessions and projects without external services.
      23 npm
      4
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Persistent, searchable project memory for Claude Code. Each project has its own local DuckDB with vector embeddings, auto-loading context at session start.
      24
      32
      MIT