# GrayMatter

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

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 490 repo stars
- Author: angelnicolasc
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/angelnicolasc/graymatter
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/graymatter

## What it 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`.

## Install

### Claude Code (native platform)

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

## When to use it
- 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
- 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.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
