Skip to content
MCP server

skillmem

Local skill memory for Claude Code and Codex: useful skills grow, stale ones fade

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.13.0
Listing updated
2 days ago

About skillmem

skillmem is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

Where most memory tools store facts, skillmem stores procedures: a trigger, the steps taken, the outcome and lessons learned. Everything sits in a plain SQLite file on your disk, and reads and writes make no LLM calls, so there is no API key and no per-use cost.

Skills are ranked by how often they actually helped. Strength rises only on evidence from outside the agent's own judgement, such as a passing test, and drops after a failure. Skills left unused fade on an Ebbinghaus-style schedule, and dead ones are moved to a backed-up archive rather than deleted.

Every memory records its origin (owner, agent, imported or derived), and only the owner can approve one as a rule. Unapproved memories are injected inside a marked block that says they are data, not instructions. Each change is also appended to a SHA-256 hash chain that skillmem verify can check for tampering.

Install

Run in a terminal

claude mcp add skillmem -- uvx skillmem

Add to claude_desktop_config.json

{
  "mcpServers": {
    "skillmem": {
      "command": "uvx",
      "args": [
        "skillmem"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "skillmem": {
      "command": "uvx",
      "args": [
        "skillmem"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "skillmem": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "skillmem"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "skillmem": {
      "command": "uvx",
      "args": [
        "skillmem"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "skillmem": {
      "command": "uvx",
      "args": [
        "skillmem"
      ]
    }
  }
}

Configuration

  • SKILLMEM_DBPath to the SQLite database file (default: the platform data directory)

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

mem_learn
Lets an agent record a skill or note into memory; an agent-written rule stays unapproved until the owner trusts it.

What it does

Zero-cost reads and writes
Storing and recalling skills uses no LLM calls, cloud service or API key.
Bilingual hybrid search
Full-text search with stemming for English and Russian, plus an optional local embedding layer for cross-language recall.
Earned skill strength
Strength grows on external evidence, falls after failures and decays when a skill goes unused.
Provenance and owner trust
Each memory records its source, and only the owner can approve a memory as a rule.
Tamper-evident history
Edits are chained with SHA-256 so after-the-fact changes can be detected.
Shared across agents
Claude Code and Codex use one database, and each record notes which agent wrote it.
Markdown export
`export-all` dumps memory to markdown files with YAML frontmatter that re-import to the same records.

Good for

  • Let a coding agent reuse how it solved a task last time
  • Share learned procedures between Claude Code and Codex
  • Keep an auditable record of what an agent learned and when
  • Stop imported or agent-written rules from acting as trusted instructions
  • Back up and move an agent's skills as plain markdown

Pricing

Open source

Free and Apache-2.0; a cloud sync option is on a waitlist, details not published

Prices change. Check skillmem.dev before you buy.

skillmem FAQ

Does it need an API key or cloud account?

No. It runs locally on SQLite and makes no LLM calls to store or retrieve skills.

How do I install it?

Run pip install 'skillmem[semantic]', then skillmem init --claude-code --codex. The semantic extra is what enables cross-language recall.

What licence is it under?

Apache-2.0, with the engine published on PyPI.

Can skills sync across machines?

Not yet. A skillmem cloud for syncing and team sharing has a waitlist; the local engine does not sync.

Which operating systems are supported?

The README lists macOS, Windows and Linux, with scheduled upkeep via launchd, schtasks and systemd timers or cron.

Is skillmem free?

Yes. skillmem is open source, so you can use and self-host it for free.

How do I add skillmem to Claude Code?

Run this command in your terminal: claude mcp add skillmem -- uvx skillmem

What are the best alternatives to skillmem?

The closest alternatives to skillmem are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to skillmem

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools