SkillAgentSearch skills...

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-mcp

If the server publishes to npm under a different name, use that package instead β€” check the repo README.

About this skill
πŸ”Œ

MCP Server

Model Context Protocol server

Quality Score

78/100

Supported Platforms

Claude Code
Claude Desktop

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.

Substance
29/30
Structure
20/20
Description
15/15
Adoption
4/20
Freshness
11/15

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.

SkillScoreStarsUpdatedFormat
simple-memory-mcp (this skill)by chrisribe78107mo agoMCP Server
claude-memby thedotmack100118.5ktodayCLAUDE.md
Agent-Reachby Panniantong100113.3k12d agoCLAUDE.md
Understand-Anythingby Egonex-AI10093.3k1d agoCLAUDE.md
hyperframesby heygen-com10087.1ktodayCLAUDE.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.

🧠 Simple Memory MCP Server

npm version License: MIT TypeScript

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.

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.

<details> <summary><strong>πŸ“– End-to-End Example</strong></summary>

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 |

<details> <summary>GraphQL Schema (for developers)</summary>
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: "...") { ... } }

</details>

βš™οΈ 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

  1. Fork the repository
  2. Create feature branch (git checkout -b feature/amazing-feature)
  3. Commit changes (git commit -m 'Add amazing feature')
  4. Push to branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

πŸ“„ License

MIT License - see LICENSE for details.


πŸ™ Acknowledgments


<div align="center">

⬆ back to top

Made with ❀️ by chrisribe

</div>

Related Skills

View on GitHub
GitHub Stars10
CategoryAI
Updated7mo ago
Forks2

Languages

TypeScript

Trust signals

91/100

From repository metadata: license, adoption, age and documentation. Not a code audit β€” see the Safety scan above for what the skill file itself contains.

1 low1 info