MCP Server — Memorius

Connect an MCP client

Run the server, then register it in your client's MCP config.

memorius serve

Generic MCP client config (Claude Code, Codex, Gemini all use a similar shape):

{
  "mcpServers": {
    "memorius": {
      "command": "memorius",
      "args": ["serve"]
    }
  }
}

The tools surface immediately. Each tool returns a JSON result that your agent can read without a custom SDK.

Agent	Install command
Claude Code	`claude mcp add memorius -- memorius serve`
Codex CLI	`codex mcp add memorius -- memorius serve`
Gemini CLI	`gemini mcp add memorius $(which memorius) serve`
Cursor	Add to `.cursor/mcp.json`: `{"mcpServers": {"memorius": {"command": "memorius", "args": ["serve"]}}}`
Aider	`aider --mcp-servers memorius=memorius serve`

Store, read, update, and search memories in the vault hierarchy.

Tool	What it does
`memorius_store`	Store content in a vault/shelf/folder/note path; supports `ttl_days`.
`memorius_search`	Semantic search with `expand_graph`, `rerank`, `tags`, and cursor pagination.
`memorius_get`	Fetch one memory by UUID, including full content + metadata.
`memorius_update`	Update content/metadata; re-embeds when content changes.
`memorius_delete`	Delete a memory by ID from both vector and metadata stores.
`memorius_list`	List memories with cursor pagination (newest first).
`memorius_vault_ls`	Browse the vault hierarchy — vaults, shelves, folders, notes.
`memorius_context`	Formatted memory block for injection into agent context.
`memorius_contradictions`	Memories that contradict a given memory (knowledge-graph `contradicts` edges).

Turn raw conversation into structured memories.

Tool	What it does
`memorius_mine`	Extract memories from a conversation transcript into the `conversations` shelf.
`memorius_extract`	LLM-structured extraction — decisions, preferences, facts, action items.
`memorius_diary_write`	Write a session diary entry.
`memorius_diary_list`	List recent diary entries across sessions.
`memorius_factcheck`	Fact-check a statement; surfaces contradictions.
`memorius_session_profile`	Build a session memory profile for inheritance.

Tool	What it does
`memorius_graph_stats`	Knowledge-graph statistics — nodes, edges, relations.
`memorius_graph_export`	Export or query graph topology; can emit a self-contained HTML visualization.
`memorius_memory_stats`	Memory tracking — total, active, archived, by vault.
`memorius_stats`	Compact vault stats for status display.
`memorius_status`	Vault count, memory count, recent diaries, embedding provider.
`memorius_prune`	Find stale memories by decay score; optionally archive or delete.
`memorius_consolidate`	Merge similar memories, extract insights.

Agent self-improvement loop — capture a learning, recall it later, track how often it's applied.

Tool	What it does
`memorius_learn`	Store a learning — bug fix, strategy, pattern, tool tip, snippet, or workflow.
`memorius_recall`	Search past learnings by category/tag.
`memorius_learnings`	List all learnings with application counts and summary.
`memorius_apply_learning`	Mark a learning as applied (increments its counter).
`memorius_learning_stats`	Learning statistics — counts, categories, application rates, confidence.

Tool	What it does
`memorius_doctor`	Run health checks — config, storage, vector store, graph integrity.
`memorius_repair`	Reconcile vector ↔ metadata drift; remove orphans, optionally re-embed. New in v0.8.6.

Memorius is MIT-licensed and fully open source. Star the repo, open an issue, or dig into the source on GitHub.