# OpenMemory

> Free, no-signup memory service for AI agents. Create a space with one HTTP call, then use a REST API or a Streamable HTTP MCP server for facts with full-text recall, a journal, typed records, an approval ledger, KV, events, one-call context, atomic batch writes, hard-delete forget, and nightly dreaming.

- REST API: https://api.openmemory.sh (interactive reference: https://api.openmemory.sh/docs, OpenAPI 3.0: https://api.openmemory.sh/openapi.json)
- MCP server: https://mcp.openmemory.sh (Streamable HTTP, stateless; header `Authorization: Bearer om_...`)
- Get a key: `curl -X POST https://api.openmemory.sh/v1/spaces -H 'content-type: application/json' -d '{"timezone":"UTC"}'` returns `{space_id, api_key}`. The key is shown once.
- Every docs page is Markdown: append `.md` to its URL or send `Accept: text/markdown`. All docs in one file: https://openmemory.sh/llms-full.txt
- Skill: `npx skills add lalagias/openmemory` (https://github.com/lalagias/openmemory/tree/main/skills/openmemory)
- Source: https://github.com/lalagias/openmemory

## Start here

- [OpenMemory docs](https://openmemory.sh/docs.md): Free, no-signup memory for AI agents. A REST API and an MCP server for facts, a journal, typed records, an approval ledger, KV, events, and nightly dreaming.
- [Quickstart](https://openmemory.sh/docs/quickstart.md): Create a memory space, store a fact, and read it back, using curl or MCP. No account needed.
- [Agent quickstart](https://openmemory.sh/docs/agent-quickstart.md): A copy-paste prompt that makes your agent create an OpenMemory space, store the key safely, connect, and use memory on every task.

## Concepts

- [Concepts](https://openmemory.sh/docs/concepts.md): The primitives in an OpenMemory space - memories, journal, records, actions, KV, events, context, batch, and forget - and how they fit together.
- [Dreaming](https://openmemory.sh/docs/dreaming.md): Nightly memory consolidation. Housekeeping without an LLM, then a model stage that runs on your agent's model (client mode) or on Workers AI (server mode). Bounded, safe for user-stated facts, and undoable for 7 days.
- [Forget and privacy](https://openmemory.sh/docs/forget-and-privacy.md): What OpenMemory stores, how forget hard-deletes with content-free tombstones, the 7-day undo history, 90-day inactivity deletion, daily index purge, and backups.
- [Limits](https://openmemory.sh/docs/limits.md): Per-space quotas, request and rate limits, and the size limits on each field. The hosted service is free, with these limits.

## Reference

- [API reference](https://openmemory.sh/docs/api-reference.md): Every OpenMemory REST endpoint with its method, path, and operationId. The full interactive reference and OpenAPI 3.0 document live at api.openmemory.sh.
- [MCP tools](https://openmemory.sh/docs/mcp-tools.md): The 15 tools the OpenMemory MCP server exposes, with their arguments. Streamable HTTP, stateless, authenticated with a bearer key.

## Agent guides

- [Claude Code](https://openmemory.sh/docs/guides/claude-code.md): Connect Claude Code to OpenMemory over MCP with one command, or with a project .mcp.json that reads the key from an environment variable.
- [Claude Desktop and claude.ai](https://openmemory.sh/docs/guides/claude-desktop.md): Add OpenMemory to Claude Desktop or claude.ai as a custom connector with a request header, or through the mcp-remote bridge when request headers are not available.
- [Cursor](https://openmemory.sh/docs/guides/cursor.md): Connect Cursor to OpenMemory with .cursor/mcp.json and read the key from an environment variable.
- [OpenAI Agents SDK and Codex](https://openmemory.sh/docs/guides/openai.md): Use OpenMemory from the OpenAI Agents SDK (Python and TypeScript), the Responses API hosted MCP tool, and the Codex CLI.
- [Guild.ai](https://openmemory.sh/docs/guides/guild.md): Import the OpenMemory OpenAPI document into Guild as an integration with API-key auth, so Guild agents get every operation as a tool.
- [Other MCP clients](https://openmemory.sh/docs/guides/mcp-clients.md): Connect any MCP client that supports Streamable HTTP and custom headers, or bridge stdio-only clients with mcp-remote.
- [REST with curl](https://openmemory.sh/docs/guides/rest.md): A tour of the OpenMemory REST API with curl - space, facts, journal, records, approvals, KV, events, batch, and forget.
- [Build your own agent loop](https://openmemory.sh/docs/guides/agent-loop.md): The pattern for a custom agent - get_context at the start of a run, one atomic batch at the end, approvals through the action ledger, and nightly dreaming on your own model.

## More

- [Self-hosting](https://openmemory.sh/docs/self-hosting.md): Run OpenMemory yourself on Node.js with built-in SQLite, or on your own Cloudflare account with Workers and D1. Same API, same MCP server.
- [FAQ](https://openmemory.sh/docs/faq.md): Common questions about OpenMemory - cost, accounts, keys, data, dreaming, and self-hosting.

## Optional

- [OpenAPI document](https://api.openmemory.sh/openapi.json): machine-readable REST API (OpenAPI 3.0.3) with stable operationIds.
- [Full docs](https://openmemory.sh/llms-full.txt): every page above concatenated into one file.