Supermemory
A memory layer that lets AI apps and assistants remember facts across conversations.
- Stars
- 31.5k
- Forks
- 2.8k
- Licence
- MIT
- Language
- TypeScript
- Last update
- 4 days ago
- Type
- App
What it is
Supermemory is a system that gives AI assistants and apps a long-term memory. It pulls facts out of conversations, keeps user profiles up to date, and supplies relevant context when it is needed, so an assistant does not start from zero each time. It can be used through a hosted API, an MCP server for AI tools like Cursor or Claude Code, or self-hosted, according to the README.
- Give Claude Code or Cursor a memory of your preferences and current projects through the MCP server
- Add per-user memory and profiles to a chatbot using the npm or pip client
- Search uploaded documents and personal memories together in one query
- Sync files from connectors such as Google Drive or Notion into a searchable knowledge base
Great for
- Developers building AI agents or chat apps that need per-user memory
- People who use Cursor, Claude Code, or other supported AI tools and want persistent context
- Teams that want a single API for memory, retrieval, and connectors instead of wiring their own vector database
- Users who want to self-host and keep data on their own machine
Not ideal for
- People who only need a simple chat history or a plain notes app, since this adds a larger system than they need
- Anyone who cannot send data to a third-party service and also cannot run the self-hosted setup, because the hosted path depends on Supermemory's cloud
- Those expecting the benchmark claims to guarantee results on their own data; the README's figures come from the authors and are not independently verified here
How to get it
- 1
Install with a package manager
You'll need: Node.js or Python (for the npm or pip client packages; versions not stated in the README excerpt)
Install the client library
npm install supermemoryOr install the Python client
pip install supermemory - 2
Run it
- Install the client library with npm or pip
- Create a client and call add() with some content and a containerTag for a user
- Call profile() with the same containerTag and a query to retrieve profile facts and matching memories
- Optionally add the MCP server URL to your AI tool's config to use memory inside that tool
- 3
Get the most out of it
- Use containerTag to separate memory by user, project, or client
- Use the MCP server or a plugin for your specific AI tool instead of writing your own integration
- Combine RAG and memory in one query for knowledge base plus personal context
- Check the docs at supermemory.ai/docs for self-hosting and connector setup
Downloads
Strengths
- Covers memory, retrieval, user profiles, and connectors in one system, per the README
- Offers both a hosted option and a self-hosted option under the MIT license
- Provides integrations with several AI SDKs and editor plugins that are open source
Trade-offs
- Many headline claims (benchmark rankings, latency figures) come from the project itself and are not checked here
- Self-hosting involves multiple components and a server setup, which is more involved than a typical app
- Hosted use means your content is processed by Supermemory's service
How it compares
| Project | Stars | Type | Level | Updated | Best for |
|---|---|---|---|---|---|
| supermemory (this) | 31.5k | App | intermediate | 4 days ago | Developers building AI agents or chat apps that need per-user memory |
| hindsight | 57.9k | AI model / agent | intermediate | 4 days ago | Developers building AI agents that need memory across sessions |
| vue-pure-admin | 20.7k | App | intermediate | 25 days ago | Developers starting a new internal admin or back-office project with Vue 3 |
| cloudflare_temp_email | 12k | App | intermediate | 5 days ago | People who want a private disposable inbox on their own domain |
| ui | 127k | Library | intermediate | 4 days ago | Developers building React or Next.js interfaces who want full control over component code |
| react-starter-kit | 23.7k | Learning resource | advanced | 4 days ago | Developers starting a SaaS-style web app who want a pre-built structure |
Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.