penfieldlabs/penfield-mcp

**Persistent memory for AI agents.** Store decisions, preferences, and context that survive across sessions. Build knowledge graphs that compound over time. Works with Claude, Cursor, Windsurf, Gemini CLI, and any MCP-compatible tool.
---
Quick Start
Claude (Desktop, Mobile, Web)
Add as a custom connector in Settings → Connectors:
Claude Code
Cursor
**One-click install:**
Install Penfield in Cursor
Cut and paste into your browser:
Or add manually to ~/.cursor/mcp.json:
Windsurf, Cline, Roo Code, and Others
Add to your MCP configuration file:
| App | Config Location |
|-----|-----------------|
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
| Cline | VS Code Settings → Cline → MCP Servers |
| Roo Code | VS Code Settings → Roo Code → MCP Servers |
| Zed | ~/.config/zed/settings.json under "context_servers" |
Gemini CLI
Or add to ~/.gemini/settings.json:
---
What You Get
**17 tools** for persistent memory:
| Category | Tools |
|----------|-------|
| **Memory** | store, recall, search, fetch, update_memory |
| **Knowledge Graph** | connect, disconnect, explore |
| **Context** | awaken, reflect, save_context, restore_context, list_contexts |
| **Artifacts** | save_artifact, retrieve_artifact, list_artifacts, delete_artifact |
**Hybrid search** combining BM25 (keyword), vector (semantic), and graph (connections) for recall that actually finds what you need.
**Cross-platform sync** — same memory, same knowledge graph, regardless of which tool you connect from.
---
How It Works
1. **Sign up** at portal.penfield.app/sign-up
2. **Connect** using one of the methods above
3. **Authenticate** when prompted (OAuth flow)
4. **Start using** — your agent now has persistent memory
Every session should start with:
Without these, your agent starts cold with no context.
---
Documentation
- Tools Reference — All 17 tools with parameters and examples
- Memory Types — The 11 memory types and when to use each
- Relationships — The 24 relationship types for connecting memories
- AI Agent Guide — Instructions for AI agents using Penfield
---
Use Cases
**Personal assistant that remembers**
- Your preferences compound over time
- Picks up conversations where you left off
- Learns how you like things done
**Development workflows**
- Track investigation threads across sessions
- Remember architectural decisions and why they were made
- Hand off context between coding sessions
**Research and writing**
- Build knowledge graphs of connected ideas