Penfield Memory

penfieldlabs/penfield-mcp

Persistent memory and knowledge graphs for AI agents that survive across sessions. Exposes 17 tools including store, recall, search for memory operations, connect and explore for building knowledge graphs, and awaken/reflect for loading context at session start. Uses hybrid search combining BM25, vector, and graph traversal. Syncs across Claude, Cursor, Windsurf, Gemini CLI, and other MCP clients through a remote server at mcp.penfield.app. Reach for this when you need your agent to remember decisions, preferences, and investigation threads between conversations, or when building compound knowledge over time instead of starting cold every session.

GitHub stars: 4
tools: 17
transport: HTTP
last updated: Feb 2, 2026

View on GitHub

Tools

17 tools

Public tool metadata for what this MCP can expose to an agent.

awaken⚡ CALL THIS TOOL FIRST IN EVERY NEW CONVERSATION ⚡ Loads your personality configuration and user preferences for this session. This is how you learn WHO you are and HOW the user wants you to behave. Returns your awakening briefing containing: - Your persona identity (who you a...

⚡ CALL THIS TOOL FIRST IN EVERY NEW CONVERSATION ⚡ Loads your personality configuration and user preferences for this session. This is how you learn WHO you are and HOW the user wants you to behave. Returns your awakening briefing containing: - Your persona identity (who you a...

No parameter schema in public metadata yet.

searchSearch for memories. Returns results with proper citation support (id, title, url, text fields). Args: query: Search query limit: Maximum results (default 10) ctx: MCP context Returns: Dict with 'results' array containing id, title, url, text fields2 params

Search for memories. Returns results with proper citation support (id, title, url, text fields). Args: query: Search query limit: Maximum results (default 10) ctx: MCP context Returns: Dict with 'results' array containing id, title, url, text fields

Parameters* required

limitinteger

default: 10

querystring

fetchFetch memory by ID. Returns a single memory with proper citation support (id, title, url, text fields). Args: id: Memory UUID to fetch ctx: MCP context Returns: Dict with id, title, url, text, metadata fields1 params

Fetch memory by ID. Returns a single memory with proper citation support (id, title, url, text fields). Args: id: Memory UUID to fetch ctx: MCP context Returns: Dict with id, title, url, text, metadata fields

Parameters* required

idstring

storeStore important information from your work. Write detailed, complete thoughts with context, reasoning, and evidence. **Always use the connect tool** to link related items - this builds knowledge graphs for better recall. ## Memory Types (auto-detected, but be aware): - **FACT*...3 params

Store important information from your work. Write detailed, complete thoughts with context, reasoning, and evidence. **Always use the connect tool** to link related items - this builds knowledge graphs for better recall. ## Memory Types (auto-detected, but be aware): - **FACT*...

Parameters* required

contentstring

importancevalue

tagsvalue

update_memoryUpdate an existing memory. Modifies properties of a stored memory by its UUID. Args: memory_id: UUID of memory to update content: New content (optional) importance: New importance score (optional, 0.0-1.0) tags: New tags (optional, replaces existing tags) ctx: MCP context (aut...4 params

Update an existing memory. Modifies properties of a stored memory by its UUID. Args: memory_id: UUID of memory to update content: New content (optional) importance: New importance score (optional, 0.0-1.0) tags: New tags (optional, replaces existing tags) ctx: MCP context (aut...

Parameters* required

contentvalue

importancevalue

memory_idstring

tagsvalue

connectConnect memories to build knowledge graphs. After using 'store', immediately connect related memories using these relationship types: ## Knowledge Evolution - **supersedes**: This replaces → outdated understanding - **updates**: This modifies → existing knowledge - **evolution...4 params

Connect memories to build knowledge graphs. After using 'store', immediately connect related memories using these relationship types: ## Knowledge Evolution - **supersedes**: This replaces → outdated understanding - **updates**: This modifies → existing knowledge - **evolution...

Parameters* required

from_memorystring

relationship_typestring

strengthvalue

to_memorystring

disconnectRemove a connection between memories. Deletes the relationship between two memories in the knowledge graph. Args: from_memory: Source memory UUID to_memory: Target memory UUID ctx: MCP context (automatically provided) Returns: Dict with success status and disconnected memory I...2 params

Remove a connection between memories. Deletes the relationship between two memories in the knowledge graph. Args: from_memory: Source memory UUID to_memory: Target memory UUID ctx: MCP context (automatically provided) Returns: Dict with success status and disconnected memory I...

Parameters* required

from_memorystring

to_memorystring

save_contextSave your cognitive state for handoff to another agent. Include your investigation context: - What session/investigation is this part of? - What role/perspective were you taking? - Who might pick this up next? (another Claude, human, Claude Code?) Reference specific memories t...2 params

Save your cognitive state for handoff to another agent. Include your investigation context: - What session/investigation is this part of? - What role/perspective were you taking? - Who might pick this up next? (another Claude, human, Claude Code?) Reference specific memories t...

Parameters* required

descriptionvalue

namestring

recallRecall relevant information. Uses hybrid search to find relevant memories, documents, and connections. Args: query: What to search for source_type: Optional filter ('memory', 'document', or None for all) tags: Optional list of tags to filter by (OR logic - memories with ANY of...6 params

Recall relevant information. Uses hybrid search to find relevant memories, documents, and connections. Args: query: What to search for source_type: Optional filter ('memory', 'document', or None for all) tags: Optional list of tags to filter by (OR logic - memories with ANY of...

Parameters* required

end_datevalue

limitinteger

default: 10

querystring

source_typevalue

start_datevalue

tagsvalue

exploreExplore connections from a memory. Traverses the knowledge graph to find related concepts, following relationships up to the specified depth. Args: start_memory: Starting memory UUID max_depth: How deep to traverse (default 3, max 10) relationship_types: Filter by specific rel...3 params

Explore connections from a memory. Traverses the knowledge graph to find related concepts, following relationships up to the specified depth. Args: start_memory: Starting memory UUID max_depth: How deep to traverse (default 3, max 10) relationship_types: Filter by specific rel...

Parameters* required

max_depthinteger

default: 3

relationship_typesvalue

start_memorystring

restore_contextResume work from a saved cognitive context. This provides a narrative briefing to quickly orient you to: - The investigation that was in progress - Key discoveries and insights made - Current hypotheses being tested - Open questions and blockers - Suggested next steps - All re...2 params

Resume work from a saved cognitive context. This provides a narrative briefing to quickly orient you to: - The investigation that was in progress - Key discoveries and insights made - Current hypotheses being tested - Open questions and blockers - Suggested next steps - All re...

Parameters* required

limitinteger

default: 20

namestring

list_contextsList available context checkpoints. Shows all saved contexts available for multi-agent workflows. Args: limit: Maximum number of contexts to return (default 20, max 100) offset: Number of contexts to skip for pagination (default 0) name_pattern: Filter contexts by name (case-i...4 params

List available context checkpoints. Shows all saved contexts available for multi-agent workflows. Args: limit: Maximum number of contexts to return (default 20, max 100) offset: Number of contexts to skip for pagination (default 0) name_pattern: Filter contexts by name (case-i...

Parameters* required

include_descriptionsboolean

default: false

limitinteger

default: 20

name_patternvalue

offsetinteger

default: 0

reflectReflect on recent thoughts and patterns. Analyzes recent activity to identify patterns, topics, and insights. Useful for understanding "what have I been thinking about?" By default, only returns user-created memories (not document chunks). Set include_documents=True to also in...4 params

Reflect on recent thoughts and patterns. Analyzes recent activity to identify patterns, topics, and insights. Useful for understanding "what have I been thinking about?" By default, only returns user-created memories (not document chunks). Set include_documents=True to also in...

Parameters* required

end_datevalue

include_documentsboolean

default: false

start_datevalue

time_windowvalue

default: recent

save_artifactSave an artifact to storage. Stores user-created content (diagrams, notes, code) in an organized file structure. Content is also indexed for search. Args: content: File content to save path: Full path including filename (e.g., "/project/docs/api.md") Returns: Success message o...2 params

Save an artifact to storage. Stores user-created content (diagrams, notes, code) in an organized file structure. Content is also indexed for search. Args: content: File content to save path: Full path including filename (e.g., "/project/docs/api.md") Returns: Success message o...

Parameters* required

contentstring

pathstring

retrieve_artifactRetrieve an artifact from storage. Fetches the content of a previously saved artifact. Args: path: Full path of the artifact (e.g., "/project/docs/api.md") Returns: Artifact content or error message Examples: >>> await retrieve_artifact("/readme.md") "# README\nThis is the rea...1 params

Retrieve an artifact from storage. Fetches the content of a previously saved artifact. Args: path: Full path of the artifact (e.g., "/project/docs/api.md") Returns: Artifact content or error message Examples: >>> await retrieve_artifact("/readme.md") "# README\nThis is the rea...

Parameters* required

pathstring

list_artifactsList artifacts in a directory. Returns the immediate contents of a directory (not recursive). Separates folders and files for easy navigation. Args: path_prefix: Directory path to list (default: "/") Returns: Formatted directory listing or error message Examples: >>> await lis...1 params

List artifacts in a directory. Returns the immediate contents of a directory (not recursive). Separates folders and files for easy navigation. Args: path_prefix: Directory path to list (default: "/") Returns: Formatted directory listing or error message Examples: >>> await lis...

Parameters* required

path_prefixstring

default: /

delete_artifactDelete an artifact from storage. Permanently removes an artifact and its associated memory record. Args: path: Full path of the artifact to delete ctx: MCP context (automatically provided) Returns: Dict with success status1 params

Delete an artifact from storage. Permanently removes an artifact and its associated memory record. Args: path: Full path of the artifact to delete ctx: MCP context (automatically provided) Returns: Dict with success status

Parameters* required

pathstring

Readme

Penfield

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:

Name: Penfield
Remote MCP server URL: https://mcp.penfield.app

Claude Code

claude mcp add --transport http --scope user penfield https://mcp.penfield.app

Cursor

One-click install:

Install Penfield in Cursor

Cut and paste into your browser:

cursor://anysphere.cursor-deeplink/mcp/install?name=Penfield&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1jcC1yZW1vdGUiLCJodHRwczovL21jcC5wZW5maWVsZC5hcHAvIl19

Or add manually to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "Penfield": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.penfield.app/"]
    }
  }
}

View the full README on GitHub

Details

Repository: github.com/penfieldlabs/penfield-mcp
Website: penfield.app
Categories: AI & LLM Tools, Documents & Knowledge, Search & Web Crawling
Transport: HTTP
Registry: MCP registry, active

Related AI & LLM Tools MCP servers

View all

Tessera MCP Servertessera-llm/mcp-serverMCP server for Tessera's LLM cost-optimization layer: anchored spend, drift, recommendations.0stars

Mcp Serveragentled/mcp-serverIntelligent AI workflow orchestration with long-term memory, 100+ integrations, and unified credits.0stars

Adaptive Recallaiappsapi/adaptive-recallAdaptive memory system with cognitive scoring, knowledge graph, and self-improving ML.3stars

Mcp Webgateannibale-x/mcp-webgateWeb search that doesn't wreck your AI's memory.3stars

Risk Deskiman/agent-driven-risk-desk-and-skillsPortfolio risk from supplied data or a synthetic example: VaR, ES, stress, credit, FRTB.0stars

Memxusgpitrella/memxus-remote-mcpPersistent memory layer that saves and recalls your project context and preferences.0stars