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 GitHubWhat 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 tograph.html. - Open
graymatter tuiand 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.