Skip to main content
MCP server CX Codex

GrayMatter — Claude Code MCP server: features and setup

GrayMatter keeps agent memory between sessions and turns recalled facts into a knowledge graph. It fits workflows where repeating old context is costly.

MIT ★ 490 updated 2026-10-09

Open on GitHub

What GrayMatter does

GrayMatter stores facts across agent runs and retrieves them by meaning rather than by keyword alone. It is distributed as one Go binary and is designed to run without Docker, a database, config files, cloud accounts, or a storage API key.

With --kg, each consolidation cycle identifies entities such as people, organizations, and projects, then connects entities that occur together. Edges retain the fact IDs behind them. You can render the graph to graph.html or graph.dot, or export it to Obsidian as notes and wikilinks.

The graymatter tui command opens a workbench for memory, recall, activity, graph, usage, and status views. --read-only blocks memory and session changes; it needs an existing store plus a running daemon, or --no-daemon.

What it helps with

  • retain facts across agent sessions
  • retrieve stored context by meaning
  • map relationships between named entities
  • inspect memory sources and graph connections
  • render the knowledge graph for Obsidian or Graphviz

Example prompts for the agent

  • Connect GrayMatter and remember the key facts from this session for the next agent run.
  • Run graymatter daemon run --kg, then render the resulting knowledge graph to graph.html.
  • Open graymatter tui and inspect the evidence behind the recalled facts.

How to install GrayMatter

Install

The MCP registry has no launch command for it: see the repository README

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about GrayMatter

How do I install GrayMatter in Claude Code?

Add GrayMatter to Claude Code as an MCP server, then start it in the agent session. GrayMatter is intended to be used through MCP.

What does GrayMatter do?

It keeps agent facts between sessions, recalls them by meaning, and builds links between entities. The server runs as a single Go binary.

What does GrayMatter need to store memory?

Memory storage does not require an API key, Docker, a database, or a cloud account. Its --read-only mode needs an existing store and either a running daemon or --no-daemon.

Similar MCP servers

MCP servers catalog →

Project sponsors

Companies that keep this analytics open