# amem

> amem is an open-source MCP server for knowledge and memory. Local memory for coding agents: facts, skills and tasks kept in one SQLite file. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows, self-hosted
- **Website:** https://getamem.com
- **Repository:** https://github.com/sslugic/amem
- **MCP Registry name:** io.github.sslugic/amem
- **Categories:** knowledge and memory, developer tools
- **Listing updated:** 2026-11-14

## About

amem tackles the habit of coding agents re-reading the same files each session. Short facts such as constraints, gotchas, decisions and owners are tied to the files they describe, and a fact is flagged stale when its file changes. Hooks hand the agent a small ranked packet at session start and with each prompt, so you don't paste a project brief.

The README's retrieval benchmark loads 36 memories and asks 32 questions phrased loosely: the automatic prompt hook put the right memory first 88% of the time and in the top three 97% of the time, while the agent-initiated amem_context path scored 81% and 94%. Vague prompts such as "ok sounds good" get no memory.

Everything sits in one SQLite file under ~/.amem, the dashboard is localhost-only, and the README states memory never leaves the machine, with no sync or cloud embeddings. Beyond facts, it keeps skills (repeatable procedures loaded only when relevant) and a Backlog, Next, Doing, Done task board agents can update. Setup is one npx command per client and needs Node 20 or later.

## Features

- **File-anchored facts:** Memories tie to source files and are flagged stale when those files change.
- **Automatic context:** Hooks supply a ranked memory packet at session start and per prompt.
- **Skills:** Stores repeatable procedures like release steps and loads them only when they apply.
- **Task board:** A Backlog to Done board that agents update so follow-ups survive chats.
- **Local dashboard:** The amem ui command shows memories, review items and tasks on localhost.
- **Private by design:** One SQLite file in ~/.amem with optional encryption and local backups.

## Good for

- Stop an agent re-learning that webhooks need the raw body for signature checks
- Seed a repository with build, test and CI facts for the first session
- Keep a release or deploy procedure available to every agent session
- Track follow-up tasks across Claude Code and Cursor sessions

## Install

### Claude Code (Terminal)

```sh
claude mcp add amem -- npx -y @iamem/amem
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "amem": {
      "command": "npx",
      "args": [
        "-y",
        "@iamem/amem"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "amem": {
      "command": "npx",
      "args": [
        "-y",
        "@iamem/amem"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "amem": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@iamem/amem"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "amem": {
      "command": "npx",
      "args": [
        "-y",
        "@iamem/amem"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "amem": {
      "command": "npx",
      "args": [
        "-y",
        "@iamem/amem"
      ]
    }
  }
}
```

## FAQ

### Does my memory leave my machine?

No. The README says there is no sync, cloud embedding or share-with-org mode.

### How do I set it up?

Run npx @iamem/amem setup --platform claude, or cursor, codex, copilot and others, then restart your client once.

### Which clients work?

Claude Code, Cursor, Claude Desktop, Copilot, Codex, Gemini CLI, Windsurf, Continue, Aider and Zed, plus any MCP client.

### What does it need?

Node 20 or later. The website says everything is free.

### How do I remove it?

Run amem uninstall to see what it added, then amem uninstall --yes. Memory stays unless you add --purge.

### Is amem free?

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

### How do I add amem to Claude Code?

Run this command in your terminal: claude mcp add amem -- npx -y @iamem/amem

### What are the best alternatives to amem?

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

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/amem
