Skip to main content
Glama
KM-it-ops

memory-mcp

by KM-it-ops
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

memory-mcp — shared-brain MCP server

A local stdio MCP server over ~/.claude/memory. Exposes the LLM-Wiki brain (read / search / write) so a memory written in any agent — Claude Code, Cursor, Codex — is readable and searchable in all three. One brain, three clients, file-backed, no external service.

Tools

Tool

What it does

memory_search

Text + frontmatter ranking over name/description/tags/body (+ bucket filter, limit).

memory_read

One memory by name → frontmatter + body + resolved outbound [[wikilinks]].

memory_list

List memories (name, type, description), optional bucket filter.

memory_links

Inbound + outbound wikilink neighbours for a memory.

memory_write

Create/update a memory, regenerate MEMORY.md + hot.md, run the brain lint. A failed lint fails the write (file left for inspection).

Related MCP server: zime-memory

Architecture

  • Standalone TypeScript (ESM, strict + exactOptionalPropertyTypes), run via tsx.

  • Reads use a strict-typed parser/scanner; a corpus-parity test asserts agreement with the real brain so frontmatter never drifts.

  • Writes delegate index/hot/lint to the existing ~/.claude/tools/brain toolkit (subprocess, CLAUDE_DIR-scoped) — brain's exact logic, no source coupling.

  • Search is text + frontmatter only (no embeddings in v1).

Config

  • CLAUDE_DIR — brain root (default ~/.claude); <CLAUDE_DIR>/memory holds the buckets.

  • BRAIN_DIR — tools/brain checkout (default <CLAUDE_DIR>/tools/brain).

Run

node node_modules/tsx/dist/cli.mjs src/server.ts   # stdio MCP server (stdout = MCP channel)
npm test        # vitest
npm run typecheck

Registration in Claude Code / Cursor / Codex: see register.md.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • claude-context-server

    carlformigoni
    A
    license
    A
    quality
    D
    maintenance
    An MCP server that reads all your Claude Code project memory files and exposes them as tools. Lets any Claude instance — in any project, or via Claude.ai — query your full project history and preferences.
    5
    6 npm
    1
    MIT

  • zime-memory

    zime78
    F
    license
    Not graded
    quality
    D
    maintenance
    A personal memory MCP server for Claude Code that stores and retrieves memories via natural language, supporting text, images, files, and secrets with vector search.
    -

  • Caduceus Memory MCP

    ethos-zero
    A
    license
    A
    quality
    C
    maintenance
    A local shared-memory MCP server for Claude, Codex, Hermes, and other MCP-aware agents, providing a durable memory layer with Markdown files and SQLite fact store.
    6
    MIT

  • claude-memory

    NathanNorman
    A
    license
    Not graded
    quality
    C
    maintenance
    A persistent memory MCP server for Claude Code that enables long-term recall across sessions via hybrid search, code intelligence, and tools for reading/writing memory.
    25 npm
    1
    MIT