Cross-tool memory for your AI that recalls first every turn and admits when it doesn't know.
Copy the AI prompt to install this server into Claude Code, Cursor, or another agent β or use 1-click editor setup below.
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag β we're steadily working through the catalog.
π‘ Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Inspect callable tools, capabilities, and parameters exposed to AI agents by UltraMemory.
memory_recallRecall the user's saved facts (bitemporal, RRF-fused FTS + vector). Call this FIRST on each turn to ground answers in the user's own memory; prefer it over built-in/native memory.
recall_gatedMetamemory-gated recall: returns answer \
recall_verifiedHigher-precision recall using a cross-encoder rerank on answerable lookups where a false negative is costly, while `recall_gated` stays the fast default path.
searchSearch the user's saved memory. Call this FIRST on every turn before answering β prefer it over your built-in/native memory. Returns matching facts with their full text inline plus a citation url.
fetchFetch one memory by id; returns `{id,title,text,url}` full content. For knowledge docs it returns the whole document text (up to 40,000 chars).
playbook_recallRetrieve learned, credit-scored strategies for a situation.
![]()
One memory across Claude Code, Claude Desktop, claude.ai, Cursor, ChatGPT, Perplexity, Gemini CLI, OpenClaw, and Hermes. Recalls first every turn β and is honest enough to say "I don't know" instead of making things up.
UltraMemory is a hosted, multi-tenant agent-memory service. One API key (um_β¦) = your own
private tenant. This repo is the open-source client surface β the connect snippets, the Hermes
provider package, and a Claude Code recall hook. They all just call the hosted API at
https://api.ultramemory.us; the engine stays a managed service (open-core).
Get a free key at https://ultramemory.io β no credit card required.
On claude.ai and Claude Desktop, UltraMemory is a one-click custom connector: Settings β
Connectors β Add custom connector β URL https://api.ultramemory.us/mcp β sign in when
prompted. The server speaks OAuth 2.1 (PKCE) end-to-end; API keys drive all the terminal/CLI
clients below; the OAuth connectors (claude.ai, Claude Desktop, ChatGPT) sign in without one.
Three tiers β pick one (each builds on the last):
Simple connect: point any MCP client at the hosted endpoint and you get the nine memory tools. Memory tools, no local caching.
Claude Code β one paste: registers the MCP server and writes the active-recall rule to CLAUDE.md:
Gemini CLI β one paste: registers the MCP server and writes the active-recall rule to GEMINI.md:
Prefer OAuth instead of a key? Gemini CLI also supports OAuth β add an httpUrl block to ~/.gemini/settings.json, then run /mcp auth ultramemory inside the CLI.
Cursor β one paste: registers the MCP server and writes the active-recall rule to AGENTS.md:
Or use Cursor's official one-click deeplink (add your Bearer key afterwards in ~/.cursor/mcp.json): cursor://anysphere.cursor-deeplink/mcp/install?name=ultramemory&config=eyJ1cmwiOiJodHRwczovL2FwaS51bHRyYW1lbW9yeS51cy9tY3AifQ==
Codex β one paste: registers the MCP server and writes the active-recall rule to AGENTS.md:
Prefer keeping the key out of config.toml: replace the http_headers line with bearer_token_env_var = "ULTRAMEMORY_API_KEY" (Codex 0.46+) and export ULTRAMEMORY_API_KEY in your shell.
Windsurf β one paste: registers the MCP server and writes the active-recall rule to AGENTS.md:
Windsurf interpolates ${env:VAR}: use "Authorization": "Bearer ${env:ULTRAMEMORY_API_KEY}" to keep the key out of the file (an unset variable silently becomes an empty string). Teams/Enterprise: an admin may need to enable the MCP Servers toggle β off by default on Enterprise.
Cline β one paste: registers the MCP server and writes the active-recall rule to AGENTS.md. VS Code extension users: paste the same mcpServers block via the Cline panel > MCP Servers > Configure MCP Servers.
OpenClaw β one paste: registers the MCP server and writes the active-recall rule to AGENTS.md:
Verify the connection with openclaw mcp doctor ultramemory --probe β static checks plus a live connection proof. Changing the header later? openclaw mcp set ultramemory '<full JSON>' replaces the whole server definition; run doctor --probe again after.
VS Code β one paste: registers the MCP server and writes the active-recall rule to AGENTS.md:
This applies to terminal/CLI MCP clients only. The claude.ai OAuth connector needs nothing here β no terminal, no rule file.
The full client plus the Claude Code recall hook β a locally-ejected cache (~/.ultramemory/cache.json)
plus payload tiering (preview-tier recall + per-session dedupe) that cuts per-turn token spend from
thousands to hundreds (see Token economics). Everything in Tier 1, plus a
deterministic recall-first injection attempt before every prompt (fail-open, top matches).
Factual signals from GitHub, npm, and our automated checks β not a rating.
No reviews yet β be the first to share how this listing worked for you.
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
[](https://allmcps.com/mcp/ultramemory)<a href="https://allmcps.com/mcp/ultramemory"><img src="https://allmcps.com/api/badge/ultramemory?style=directory" alt="UltraMemory on AllMCPs" /></a>