Piia Engram

by Patdolitse

170 stars

539 downloads

Not rated

GitHub Website

About

Persistent AI memory across tools — remember your preferences, code standards, and decisions across Claude Code, Cursor, Codex, and any MCP tool. Local-first, zero-cloud.

Details

Author: Patdolitse
GitHub stars: 170
Downloads: 539
Categories: AI, Knowledge Base, Productivity, Developer Tools, Security

- Local files you own, no cloud account required
- AI-proposed knowledge reviewed by user before high-risk writes
- Portable identity across multiple MCP-compatible coding tools
- Memory Lens (engram preview --html) shows what AI callers receive
- Field-level optional AES-256-GCM encryption for sensitive profile fields
- 17 core MCP tools (loaded by default) + 40 advanced tools (opt-in)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Piia Engram

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "piia engram": {
            "engram": {
                "command": "python",
                "args": [
                    "-m",
                    "piia_engram.mcp_server"
                ],
                "env": {
                    "ENGRAM_TOOLS": "all"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "piia engram": {
            "engram": {
                "command": "python",
                "args": [
                    "-m",
                    "piia_engram.mcp_server"
                ],
                "env": {
                    "ENGRAM_TOOLS": "all"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "piia engram": {
            "engram": {
                "command": "python",
                "args": [
                    "-m",
                    "piia_engram.mcp_server"
                ],
                "env": {
                    "ENGRAM_TOOLS": "all"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "piia engram": {
            "engram": {
                "command": "python",
                "args": [
                    "-m",
                    "piia_engram.mcp_server"
                ],
                "env": {
                    "ENGRAM_TOOLS": "all"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "piia engram": {
            "engram": {
                "command": "python",
                "args": [
                    "-m",
                    "piia_engram.mcp_server"
                ],
                "env": {
                    "ENGRAM_TOOLS": "all"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "piia engram": {
            "engram": {
                "command": "python",
                "args": [
                    "-m",
                    "piia_engram.mcp_server"
                ],
                "env": {
                    "ENGRAM_TOOLS": "all"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "piia engram": {
            "engram": {
                "command": "python",
                "args": [
                    "-m",
                    "piia_engram.mcp_server"
                ],
                "env": {
                    "ENGRAM_TOOLS": "all"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "piia engram": {
            "engram": {
                "command": "python",
                "args": [
                    "-m",
                    "piia_engram.mcp_server"
                ],
                "env": {
                    "ENGRAM_TOOLS": "all"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "piia engram": {
            "engram": {
                "command": "python",
                "args": [
                    "-m",
                    "piia_engram.mcp_server"
                ],
                "env": {
                    "ENGRAM_TOOLS": "all"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "piia engram": {
            "engram": {
                "command": "python",
                "args": [
                    "-m",
                    "piia_engram.mcp_server"
                ],
                "env": {
                    "ENGRAM_TOOLS": "all"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "piia engram": {
            "engram": {
                "command": "python",
                "args": [
                    "-m",
                    "piia_engram.mcp_server"
                ],
                "env": {
                    "ENGRAM_TOOLS": "all"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "piia engram": {
            "engram": {
                "command": "python",
                "args": [
                    "-m",
                    "piia_engram.mcp_server"
                ],
                "env": {
                    "ENGRAM_TOOLS": "all"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "piia engram": {
            "engram": {
                "command": "python",
                "args": [
                    "-m",
                    "piia_engram.mcp_server"
                ],
                "env": {
                    "ENGRAM_TOOLS": "all"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "piia engram": {
            "engram": {
                "command": "python",
                "args": [
                    "-m",
                    "piia_engram.mcp_server"
                ],
                "env": {
                    "ENGRAM_TOOLS": "all"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "piia engram": {
            "engram": {
                "command": "python",
                "args": [
                    "-m",
                    "piia_engram.mcp_server"
                ],
                "env": {
                    "ENGRAM_TOOLS": "all"
                }
            }
        }
    }
}

From the repository

Install with pip install piia-engram and run engram setup. The wizard auto-detects supported AI tools, lists the config files it will touch, writes the MCP connection after confirmation, and backs up every file before modifying it. After restarting your configured tool, its first conversation can load your approved identity and knowledge through startup or search tools.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "piia engram": {
            "engram": {
                "command": "python",
                "args": [
                    "-m",
                    "piia_engram.mcp_server"
                ],
                "env": {
                    "ENGRAM_TOOLS": "all"
                }
            }
        }
    }
}

McpServers

{
    "engram": {
        "command": "python",
        "args": [
            "-m",
            "piia_engram.mcp_server"
        ],
        "env": {
            "ENGRAM_TOOLS": "all"
        }
    }
}

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

ENGLISH | 中文

Listed in:

Also listed in: awesome-agents · Awesome-MCP-ZH · mcpservers.org · Cursor Directory · ModelScope · PulseMCP

</div>

---

> TL;DR: piia-engram is a local-first personal AI identity layer. It helps multiple coding agents start from the same understanding of you: your preferences, quality bar, lessons learned, decisions, and project context. It is not an agent memory database; it is the user-owned layer above your tools.

Why not just use native memory? Claude Code, Codex, Cursor, and Windsurf are adding their own memories and rules. Those are useful, but they are scoped to one tool or workspace. piia-engram gives you one portable identity layer above them: local files you own, AI-proposed knowledge you review, and context that can follow you across tools.

Trust model in four lines:

- No cloud account: install with pip, keep the core store on your machine.
- Local files: identity and knowledge live under ~/.engram/ as JSON/Markdown.
- User approval: AI writes locally; high-risk items (credentials, shell commands, MCP config, permission rules) wait for your review, while low/medium writes are auto-absorbed but fully auditable and reversible. Set ENGRAM_APPROVAL=strict to gate every write.
- Documented boundaries: see Trust model, Privacy, and Security.

Want proof? See the live cross-tool continuity proof — a memory written by Claude Code, read back by Codex through one local store — or the one-command reproducible code demo.

See It in Action

```
You → "Help me refactor this auth module"

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Piia Engram

Local-first AI work identity you can see, edit, and override — portable across your MCP coding tools.

See It in Action

Install

More like this

Aws Kb Retrieval Server

Time

Memory

Context 7

1Panel

🔎 GPT Researcher