# Ori Memory (MCP server)

> Ori Memory is an MCP server that adds search and knowledge tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Persistent memory infrastructure for AI agents. It has 330 GitHub stars, is released under the Apache-2.0 license and runs locally with npx -y ori-memory.

Open-source persistent memory infrastructure for AI agents. Ori implements human cognition as mathematical models on a knowledge graph. Activation decay from ACT-R. Spreading activation along wiki-link edges. Hebbian co-occurrence from retrieval patterns. Reinforcement learning on retrieval itself. Recursive graph traversal with sub-question decomposition. The system learns what matters, forgets what doesn't, and optimizes its own retrieval pipeline.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/aayoawoyemi/Ori-Mnemos |
| GitHub stars | 330 |
| License | Apache-2.0 |
| Language | TypeScript |
| Transport | stdio |
| Packages | npm: ori-memory |
| Remote URL | none |
| Needs API key | no |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | AI & search |
| Latest release | v0.8.1 (Oct 1, 2026) |
| Last commit | Oct 1, 2026 |
| MCP registry name | io.github.aayoawoyemi/ori-memory |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "ori-memory": {
      "command": "npx",
      "args": [
        "-y",
        "ori-memory"
      ]
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --transport stdio ori-memory -- npx -y ori-memory
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ori-memory": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ori-memory"
      ]
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "ori-memory": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ori-memory"
      ]
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Tools

- `ori_wake`: Session boot: bounded briefing, plus onboarding on a fresh vault
- `ori_update`: Write to identity, goals, methodology, daily, or reminders
- `ori_update_decision`: Record the user's answer to an update notice
- `ori_whats_new`: Release notes for the installed version, or any version
- `memory_sql`: Read-only SQL over the index — anything the ranking tools cannot express
- `ori_health`: Full diagnostics
- `ori_add`: Capture to inbox
- `ori_promote`: Promote with classification, linking, and area assignment
- `ori_validate`: Schema validation
- `ori_query_ranked`: Full retrieval with Q-value reranking, co-occurrence PPR, and stage meta-learning
- `ori_query_similar`: Semantic search (vector only, faster)
- `ori_warmth`: Inspect the associative warmth field
- `ori_explore`: Recursive graph traversal — PPR, sub-question decomposition, convergence detection
- `ori_prune`: Activation topology analysis and archive candidates
- `ori_index_build`: Build/update embedding index and bootstrap co-occurrence edges
- `ori_status`: SELECT COUNT() FROM vnote
- `ori_query_important`: SELECT title, pagerank FROM vnote ORDER BY pagerank DESC
- `ori_query_fading`: oriprune, which its own description already deferred to

## Similar MCP servers

- [Context7](https://appsgit.com/mcp-servers/context7): Up-to-date code docs for any prompt. (62,752 stars, MIT, needs API key)
- [FunASR](https://appsgit.com/mcp-servers/funasr): Transcribe local audio with FunASR and SenseVoice using private, on-device inference. (20,596 stars, MIT)
- [Bifrost](https://appsgit.com/mcp-servers/bifrost): Fastest enterprise AI gateway (50x faster than LiteLLM) with adaptive load balancer, cluster mode, guardrails, 1000+ models support & <100 µs overhead at 5k RPS. (8,591 stars, Apache-2.0)
- [Honcho](https://appsgit.com/mcp-servers/honcho): Memory that reasons: continual learning for stateful agents. (7,494 stars, AGPL-3.0, needs API key)
- [Semble](https://appsgit.com/mcp-servers/semble): Fast and Accurate Code Search for Agents. (6,185 stars, MIT)
- [Exa](https://appsgit.com/mcp-servers/exa): Connect AI agents to Exa for web search, content fetching, and multi-step research. (5,088 stars, MIT, official)

---

Canonical page: https://appsgit.com/mcp-servers/ori-memory
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.