Piia Engram
This is a local-first memory layer that sits above your AI coding tools. Install it once, tell it your preferences and standards, and every MCP-compatible client (Claude Code, Cursor, Codex, Windsurf) reads from the same identity store. It exposes tools for AI to propose lessons, decisions, and context updates, but nothing becomes permanent until you approve it. All data lives in JSON and Markdown files under ~/.engram/ that you can inspect, edit, or version control. You'd reach for this if you're tired of re-explaining your code review bar every time you open a new chat window or switch between tools. The trust model is straightforward: no cloud, no vendor lock-in, and AI can only suggest changes to your memory, not write them directly.
- GitHub stars
- 165
- tools
- 53
- transport
- STDIO
- env vars
- 3
- last updated
- Nov 1, 2026
Tools
53 toolsPublic tool metadata for what this MCP can expose to an agent.
get_user_contextLoad identity + knowledge at session start (supports token_budget for context size control)
Load identity + knowledge at session start (supports token_budget for context size control)
No parameter schema in public metadata yet.
wrap_up_sessionSave insights + sync at session end
Save insights + sync at session end
No parameter schema in public metadata yet.
memory_storeUnified write endpoint: routes to add_lesson / add_decision / add_playbook by kind
Unified write endpoint: routes to add_lesson / add_decision / add_playbook by kind
No parameter schema in public metadata yet.
add_lessonStore a reusable lesson learned
Store a reusable lesson learned
No parameter schema in public metadata yet.
add_decisionRecord a key decision with reasoning
Record a key decision with reasoning
No parameter schema in public metadata yet.
add_playbookRecord an operational playbook (multi-step procedure with trigger keywords)
Record an operational playbook (multi-step procedure with trigger keywords)
No parameter schema in public metadata yet.
search_knowledgeSearch lessons, decisions, and playbooks (supports filters_json for domain/tier/date filtering)
Search lessons, decisions, and playbooks (supports filters_json for domain/tier/date filtering)
No parameter schema in public metadata yet.
get_relevant_knowledgeFind knowledge relevant to current project
Find knowledge relevant to current project
No parameter schema in public metadata yet.
get_recallReturn one structured identity + recent activity + relevant knowledge recall payload
Return one structured identity + recent activity + relevant knowledge recall payload
No parameter schema in public metadata yet.
get_knowledge_historyRead one item's revision history (superseded snapshots; exact by-version lookup)
Read one item's revision history (superseded snapshots; exact by-version lookup)
No parameter schema in public metadata yet.
get_identity_cardOwner-gated export: write and return a Markdown identity card for non-MCP tools
Owner-gated export: write and return a Markdown identity card for non-MCP tools
No parameter schema in public metadata yet.
update_identityPropose identity, preference, or quality-standard changes for local review (all modes)
Propose identity, preference, or quality-standard changes for local review (all modes)
No parameter schema in public metadata yet.
get_project_contextRead a saved project snapshot
Read a saved project snapshot
No parameter schema in public metadata yet.
save_project_snapshotPersist project state for future sessions
Persist project state for future sessions
No parameter schema in public metadata yet.
get_recent_contextRecover lost session context after restart
Recover lost session context after restart
No parameter schema in public metadata yet.
get_daily_logRead a human-friendly project timeline for a day
Read a human-friendly project timeline for a day
No parameter schema in public metadata yet.
get_resume_briefBuild a cross-session/cross-tool resume brief
Build a cross-session/cross-tool resume brief
No parameter schema in public metadata yet.
get_wrap_up_session_statusQuery a closeout operation by its idempotency key before retrying
Query a closeout operation by its idempotency key before retrying
No parameter schema in public metadata yet.
doctorRun memory system self-diagnosis
Run memory system self-diagnosis
No parameter schema in public metadata yet.
register_toolOptional local integration governed write: register a local tool, runtime, or CLI to the environment map
Optional local integration governed write: register a local tool, runtime, or CLI to the environment map
No parameter schema in public metadata yet.
find_toolOptional local integration: look up a registered local tool by name
Optional local integration: look up a registered local tool by name
No parameter schema in public metadata yet.
list_toolsOptional local integration: list registered local tools (optionally filter by category)
Optional local integration: list registered local tools (optionally filter by category)
No parameter schema in public metadata yet.
save_agent_contextSave AI session checkpoint (also runs automatically)
Save AI session checkpoint (also runs automatically)
No parameter schema in public metadata yet.
list_agent_sessionsBrowse saved session records across tools
Browse saved session records across tools
No parameter schema in public metadata yet.
refresh_quick_contextRefresh local quick_context.md snapshot for offline/cross-tool use
Refresh local quick_context.md snapshot for offline/cross-tool use
No parameter schema in public metadata yet.
get_identity_facetsRead identity facets via facet: profile, preferences, trust_boundaries, work_style, quality_standards, domains, or all
Read identity facets via facet: profile, preferences, trust_boundaries, work_style, quality_standards, domains, or all
No parameter schema in public metadata yet.
user_portraitaction: get / save / compare the AI-maintained user portrait
action: get / save / compare the AI-maintained user portrait
No parameter schema in public metadata yet.
preview_context_governanceAdvanced owner-gated preview: build safe-context, freshness/conflict, replay, or evidence proposals without applying changes
Advanced owner-gated preview: build safe-context, freshness/conflict, replay, or evidence proposals without applying changes
No parameter schema in public metadata yet.
get_playbooksPlaybook reads via mode: list, get (full content), recent, management (incl. archived/deleted metadata)
Playbook reads via mode: list, get (full content), recent, management (incl. archived/deleted metadata)
No parameter schema in public metadata yet.
manage_playbookPlaybook lifecycle via action: update, archive, delete, restore (mutations stay confirm-gated and need expected_version)
Playbook lifecycle via action: update, archive, delete, restore (mutations stay confirm-gated and need expected_version)
No parameter schema in public metadata yet.
playbook_executionGuided execution via action: prepare a step plan, update_step, status rollup (passive reference; no auto-execution)
Guided execution via action: prepare a step plan, update_step, status rollup (passive reference; no auto-execution)
No parameter schema in public metadata yet.
get_lessonsList reusable lessons learned
List reusable lessons learned
No parameter schema in public metadata yet.
get_decisionsList key decisions; thread_seed_id / history_question reconstruct decision threads and revision history
List key decisions; thread_seed_id / history_question reconstruct decision threads and revision history
No parameter schema in public metadata yet.
get_knowledge_inheritanceBuild cross-project knowledge starter pack
Build cross-project knowledge starter pack
No parameter schema in public metadata yet.
list_projectsList saved project snapshots
List saved project snapshots
No parameter schema in public metadata yet.
extract_session_insightsExtract lessons and decisions from session text
Extract lessons and decisions from session text
No parameter schema in public metadata yet.
ingest_notesParse free-form notes into structured knowledge
Parse free-form notes into structured knowledge
No parameter schema in public metadata yet.
update_knowledgeUpdate a lesson, decision or playbook by ID (needs expected_version)
Update a lesson, decision or playbook by ID (needs expected_version)
No parameter schema in public metadata yet.
archive_knowledgeArchive a lesson, decision or playbook by ID (needs expected_version)
Archive a lesson, decision or playbook by ID (needs expected_version)
No parameter schema in public metadata yet.
confirm_knowledgeOwner-only confirmation stamp via human, test, or anchor provenance
Owner-only confirmation stamp via human, test, or anchor provenance
No parameter schema in public metadata yet.
onboard_repoOwner-only repo scan: create staging repo-fact candidates from anchors
Owner-only repo scan: create staging repo-fact candidates from anchors
No parameter schema in public metadata yet.
onboard_acceptLocal only: accepting an onboard candidate is engram onboard-accept <id>; over MCP it answers local_review_only and writes nothing
Local only: accepting an onboard candidate is engram onboard-accept <id>; over MCP it answers local_review_only and writes nothing
No parameter schema in public metadata yet.
check_anchorsOwner-only revalidation for existing anchor-backed facts
Owner-only revalidation for existing anchor-backed facts
No parameter schema in public metadata yet.
merge_knowledgeMerge a duplicate into the primary item (needs both items' versions)
Merge a duplicate into the primary item (needs both items' versions)
No parameter schema in public metadata yet.
manage_relationaction: link / unlink — manage typed relations between knowledge items (decision threads)
action: link / unlink — manage typed relations between knowledge items (decision threads)
No parameter schema in public metadata yet.
explore_knowledgeKnowledge graph exploration via mode: related, similar, merge_candidates
Knowledge graph exploration via mode: related, similar, merge_candidates
No parameter schema in public metadata yet.
get_knowledge_overviewKnowledge digest, health report, stale checks
Knowledge digest, health report, stale checks
No parameter schema in public metadata yet.
get_stale_knowledgeList items that need review
List items that need review
No parameter schema in public metadata yet.
review_stagingStaging review via action: list pending, batch preview (dry_run=true), review_item. Approving, rejecting or archiving pending items is local only (engram review); over MCP it answers local_review_only
Staging review via action: list pending, batch preview (dry_run=true), review_item. Approving, rejecting or archiving pending items is local only (engram review); over MCP it answers local_review_only
No parameter schema in public metadata yet.
export_knowledge_reportOwner-gated export: write a readable Markdown knowledge report
Owner-gated export: write a readable Markdown knowledge report
No parameter schema in public metadata yet.
request_outline_reviewOwner-gated export: generate an interactive local HTML review page
Owner-gated export: generate an interactive local HTML review page
No parameter schema in public metadata yet.
export_engramOwner-gated export: write a full backup (format="openclaw" for OpenClaw-compatible files)
Owner-gated export: write a full backup (format="openclaw" for OpenClaw-compatible files)
No parameter schema in public metadata yet.
import_engramOwner/admin import preview only (dry_run=True)
Owner/admin import preview only (dry_run=True)
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
ENGRAM_MCP_STARTUP_SYNCdefault: offKept for compatibility; has no effect. The server never imports other AI tools' memories at start (the user runs engram import-memories for that).
ENGRAM_TOOLSdefault: coreExpose the context-budget friendly default surface; set to all for the full advanced surface.
PYTHONIOENCODINGdefault: utf-8Force UTF-8 stdio frames on Windows-style consoles.
Readme
Piia Engram
Local-first AI work identity you can see, edit, and override — portable across your MCP coding tools.
Tell AI once who you are, how you work, and what "good" means. Claude Code, Codex, Cursor, Windsurf, and other MCP-compatible tools can start from the same AI work identity layer — local files you own, no cloud account, no hidden memory you cannot inspect.
Install · See It in Action · Supported Tools · MCP Tools · FAQ
Details
- Repository
- github.com/patdolitse/piia-engram
- Website
- github.com/Patdolitse/piia-engram
- Package
piia-engram- Transport
- STDIO
- Registry
- MCP registry, active