poppy — Claude Code MCP server: features and setup
poppy keeps decisions, preferences, and lessons in a local store, then retrieves relevant memories for an AI coding agent. Use it to carry project context across sessions.
Apache-2.0 ★ 2 updated 2026-10-25
claude mcp add poppy -- uvx poppy-memoryWhat poppy does
poppy saves facts, decisions, preferences, and lessons in a local SQLite store. An agent can add memories, search for relevant ones, and remove or consolidate them through MCP. The same actions are available from the poppy remember and poppy recall CLI commands.
For Claude Code, add the server with the command in the FAQ and restart the agent. It runs through uvx poppy-memory; you can install the package with pipx install poppy-memory. Hooks call poppy by name, so they fail if the agent cannot find that command on its PATH. Claude Code also has memory-capture hooks, while automatic capture needs one-time consent.
What it helps with
- save a project decision for later sessions
- retrieve a preference from a natural-language query
- bring earlier project context into an agent session
- remove or consolidate stored memories
Example prompts for the agent
- Remember that we use
uvfor Python dependencies. - Recall which package manager I chose for Python.
- Remove the outdated memory about the project setup.
How to install poppy
Platform CLI
claude mcp add poppy -- uvx poppy-memoryuvx runs the command named after the package; if the README names another one, use uvx --from poppy-memory <command>
Platform CLI
codex mcp add poppy -- uvx poppy-memoryuvx runs the command named after the package; if the README names another one, use uvx --from poppy-memory <command>
Config file
{
"mcpServers": {
"poppy": {
"command": "uvx",
"args": [
"poppy-memory"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from poppy-memory <command>
Config file
{
"servers": {
"poppy": {
"type": "stdio",
"command": "uvx",
"args": [
"poppy-memory"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from poppy-memory <command>
Platform CLI
gemini mcp add poppy uvx poppy-memoryuvx runs the command named after the package; if the README names another one, use uvx --from poppy-memory <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about poppy
How do I install poppy in Claude Code?
Run claude mcp add poppy -- uvx poppy-memory, then restart Claude Code so it loads the MCP server.
What does poppy do?
It stores decisions, preferences, and lessons locally, then retrieves relevant entries when an agent asks. The agent accesses the memory through MCP.
Where does poppy keep its memories?
Memories go into a local SQLite store. The service does not send them to the cloud, and it does not require API keys.