simple-memory-mcp
π§ Persistent local memory for AI assistants across conversations. SQLite, no cloud, no config, works with any MCP client.
Install / Use
claude mcp add chrisribe -- npx -y github:chrisribe/simple-memory-mcpIf the server publishes to npm under a different name, use that package instead β check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
AI & Machine LearningSupported Platforms
Tags
Our assessment of simple-memory-mcp
simple-memory-mcp scores 78/100 on our quality scale, 787th of 944 AI & Machine Learning skills we index.
Its MCP Server is 8.8 KB long, well organised into 22 sections with 14 code examples: a thorough specification that gives an agent plenty to work with.
It has 10 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated about 7 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 91/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit β read the skill file before letting an agent act on it.
simple-memory-mcp compared with similar skills
All 4 of these similar skills score higher than simple-memory-mcp; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| simple-memory-mcp (this skill)by chrisribe | 78 | 10 | 7mo ago | MCP Server |
| claude-memby thedotmack | 100 | 118.5k | today | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 113.3k | 12d ago | CLAUDE.md |
| Understand-Anythingby Egonex-AI | 100 | 93.3k | 1d ago | CLAUDE.md |
| hyperframesby heygen-com | 100 | 87.1k | today | CLAUDE.md |
Frequently asked questions
- How do I install simple-memory-mcp?
- Run
claude mcp add chrisribe -- npx -y github:chrisribe/simple-memory-mcp. The install tabs above show the steps for each supported agent. - Which AI agents does simple-memory-mcp work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is simple-memory-mcp safe to use?
- It is MIT-licensed and scores 91/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is simple-memory-mcp still maintained?
- The repository was last updated about 7 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubπ§ Simple Memory MCP Server
Give your AI assistant persistent memory across sessions.
π Looking for the next evolution?
git-memory is now my daily driver β it builds on the ideas from simple-memory and takes them further. If you're starting fresh, check it out! Simple-memory is still functional but is no longer my main focus.
The problem: AI assistants forget everything when you start a new conversation. Your preferences, project context, decisions - all gone.
The solution: Simple Memory lets AI store and retrieve information that persists forever. Local SQLite database, zero cloud, sub-millisecond fast.
Why not RAG? RAG systems need vector databases, embeddings, chunking strategies, and ongoing maintenance. Simple Memory is just keyword search in SQLite - no ML infrastructure, no API costs, works offline. Perfect for personal knowledge that doesn't need semantic similarity.
How It Works
You: "Remember that I prefer TypeScript over JavaScript and use 4-space indentation"
AI: stores this automatically
...days later, new session...
You: "Help me set up a new project"
AI: searches memory, finds your preferences β Sets up TypeScript with 4-space indentation
The AI handles storage and retrieval automatically. You just chat naturally.
<details> <summary><strong>π End-to-End Example</strong></summary>Simple by design: Keyword search, not semantic. Local SQLite, not cloud. Zero setup, not configuration hell. If you need vector embeddings or team collaboration, see alternatives.
Session 1 (January):
You: "I'm using PostgreSQL with TypeScript. Decided on Prisma ORM after
evaluating TypeORM - better type inference and migrations."
AI: β stores automatically with tags [tech-stack, database, decision]
Session 2 (3 weeks later):
You: "Setting up a new microservice, what database setup should I use?"
AI: β searches memories, finds your PostgreSQL + Prisma decision
"Based on your previous work, you standardized on PostgreSQL with Prisma
ORM. You chose it over TypeORM for the better type inference..."
What got stored:
{
"content": "Tech stack decision: PostgreSQL + Prisma ORM. Chose over TypeORM for better type inference and cleaner migrations.",
"tags": ["tech-stack", "database", "decision"],
"relevance": 0.92 // BM25 score when searching "database setup"
}
</details>
π€ Why I built this
I got tired of every new conversation starting from zero. I use this daily - saving project status, gotchas, ideas that pop up while Iβm deep in work. Instead of breaking flow to write things down somewhere, I just tell the assistant to save it and keep going. Having it all central means I can reference old solutions, things that failed, things that worked - across projects, across time. Itβs basically an external memory for my dev brain.
β¨ Features
- π§ Persistent Memory - Survives across sessions, restarts, forever
- π Full-Text Search - Find memories by keyword, tags, or content
- π·οΈ Smart Tagging - Organize memories with tags
- πΎ Automatic Backups - Optional sync to OneDrive/Dropbox
- π¦ Zero Config - Works out of the box
- π Fast - Sub-millisecond queries, 2,000-10,000 ops/sec
π Quick Start
Configure MCP Client
Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"simple-memory": {
"command": "npx",
"args": ["-y", "simple-memory-mcp"]
}
}
}
VS Code (.vscode/mcp.json):
{
"mcpServers": {
"simple-memory": {
"command": "npx",
"args": ["-y", "simple-memory-mcp"]
}
}
}
Restart your MCP client - that's it! No install needed.
π‘ Best Experience: Works best with Claude Sonnet in Agent Mode for optimal auto-capture.
Auto-Configure VS Code & Claude Desktop
npx -y simple-memory-mcp setup
This automatically configures all detected installations.
Optional: Install CLI
For command-line usage (search, stats, export/import):
npm install -g simple-memory-mcp
simple-memory setup # auto-configure VS Code & Claude
For Contributors
git clone https://github.com/chrisribe/simple-memory-mcp.git
cd simple-memory-mcp
npm run setup # installs, builds, links, and configures
That's it! The AI assistant can now remember information across conversations.
π» CLI Commands
# Setup - auto-configure VS Code and Claude Desktop
simple-memory setup
# Search memories
simple-memory search --query "typescript" --limit 5
simple-memory search --tags "project,work"
# Store a memory
simple-memory store --content "Remember this" --tags "note"
# Other operations
simple-memory get --hash "abc123..."
simple-memory delete --hash "abc123..."
simple-memory stats
# Export/import
simple-memory export-memory --output backup.json
simple-memory import-memory --input backup.json
Run simple-memory --help for all options.
π οΈ MCP Tools
The AI uses these tools automatically - you don't need to call them directly.
| Tool | Purpose |
|------|---------|
| memory-graphql | Store, search, update, delete memories |
| export-memory | Backup memories to JSON file |
| import-memory | Restore memories from JSON file |
type Memory { hash, content, title, preview, tags, createdAt, relevance }
type StoreResult { success, hash, error }
type UpdateResult { success, hash, error }
type DeleteResult { success, hash, deletedCount, error }
type Query {
memories(query: String, tags: [String], limit: Int): [Memory!]!
memory(hash: String!): Memory
related(hash: String!, limit: Int): [Memory!]!
stats: Stats!
}
type Mutation {
store(content: String!, tags: [String]): StoreResult!
update(hash: String!, content: String!, tags: [String]): UpdateResult!
delete(hash: String, tag: String): DeleteResult!
}
Note: Mutation results return minimal data (hash/success). To get full memory fields (title, tags, createdAt), query: { memory(hash: "...") { ... } }
βοΈ Configuration
Zero config default: ~/.simple-memory/memory.db
Custom database location:
{
"mcpServers": {
"simple-memory": {
"command": "npx",
"args": ["-y", "simple-memory-mcp"],
"env": {
"MEMORY_DB": "/path/to/memory.db"
}
}
}
}
With automatic backups:
{
"env": {
"MEMORY_BACKUP_PATH": "/path/to/OneDrive/backups",
"MEMORY_BACKUP_INTERVAL": "180"
}
}
π Full configuration guide: docs/configuration.md
- Environment variables reference
- Backup strategies
- Cloud storage best practices
- HTTP transport setup
- Multiple database instances
π§ Development
npm install # Install dependencies
npm run build # Build TypeScript
npm test # Run tests
npm run benchmark # Performance benchmarks
Testing:
npm test # GraphQL tests
npm run test:perf # Performance tests
npm run test:migration # Migration tests
π Documentation
| Guide | Description | |-------|-------------| | Configuration | Full config reference, backups, cloud storage, HTTP transport | | Examples | Real-world scenarios, namespace patterns | | Design Philosophy | Trade-offs, BM25 relevance scoring | | Performance | Benchmarks and optimization details | | Web Server | Visual memory browser interface | | Changelog | Version history |
Developer Docs: docs/dev/ - Manual testing, publishing guide, optimization history
π€ Contributing
- Fork the repository
- Create feature branch (
git checkout -b feature/amazing-feature) - Commit changes (
git commit -m 'Add amazing feature') - Push to branch (
git push origin feature/amazing-feature) - Open a Pull Request
π License
MIT License - see LICENSE for details.
π Acknowledgments
<div align="center">
Made with β€οΈ by chrisribe
</div>Related Skills
claude-mem
118.5kPersistent Context Across Sessions for Every Agent β Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Agent-Reach
113.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu β one CLI, zero API fees.
Understand-Anything
93.3kGraphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
hyperframes
87.1kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit β see the Safety scan above for what the skill file itself contains.
