# Poppy

> Poppy is an open-source MCP server for knowledge and memory. Local memory store that lets every coding agent recall your decisions and lessons. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://trags.ai/poppy
- **Repository:** https://github.com/trags-garden/poppy
- **MCP Registry name:** ai.trags/poppy
- **Categories:** knowledge and memory, developer tools
- **Listing updated:** 2026-11-14

## About

Memory lives in a small SQLite store under ~/.poppy on your machine, so no cloud, API key or per-query fee is involved. You or your agent save a decision, preference, fact or lesson in plain prose, and a recall query returns the few most relevant entries. Each record stores an id, type, content, project, source and capture date.

A single command per client wires it up. The site lists setup for Claude Code, Claude Desktop, Codex, Copilot CLI, Cursor, Gemini CLI, Goose and Hermes Agent, and the README adds VS Code, Windsurf and Pi. Some setups add lifecycle hooks and a primer block, so memory carries across sessions like /clear and /resume. With consent it can extract memories from sessions locally. Syncing to Trags is optional and off by default.

Install with pipx or uv (Python 3.11 or newer), check that poppy is on your PATH, restart the agent, then run poppy doctor to verify. It is released under Apache-2.0.

## Features

- **Plain-prose memories:** Stores decisions, preferences, facts and lessons as short sentences.
- **One store for many agents:** Claude Code, Cursor, Codex and others read the same local memory.
- **One-command setup:** poppy setup <client> writes the MCP entry and, where supported, hooks.
- **Automatic capture:** Optionally extracts durable memories from sessions locally, with consent.
- **Diagnostics:** poppy doctor checks engine, storage, MCP config and hooks.
- **Optional sync:** Pairing with Trags is separate and off by default.

## Good for

- Keep a team's tooling preferences across agents
- Record a hard-won debugging lesson once
- Carry decisions across /clear and resumed sessions
- Share project context between Cursor and Claude Code

## Install

### Claude Code (Terminal)

```sh
claude mcp add poppy -- uvx poppy-memory
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "poppy": {
      "command": "uvx",
      "args": [
        "poppy-memory"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "poppy": {
      "command": "uvx",
      "args": [
        "poppy-memory"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "poppy": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "poppy-memory"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "poppy": {
      "command": "uvx",
      "args": [
        "poppy-memory"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "poppy": {
      "command": "uvx",
      "args": [
        "poppy-memory"
      ]
    }
  }
}
```

## FAQ

### Does it send data anywhere?

No by default. The store is local; cloud sync is an extra command.

### What do I need to install it?

pipx or uv, with Python 3.11 or newer.

### Which licence?

Apache-2.0.

### Why do hooks fail with command not found?

The agent may not have poppy on its PATH; fix PATH and restart the agent.

### Is Poppy free?

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

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

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

### What are the best alternatives to Poppy?

The closest alternatives to Poppy 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/poppy
