Engram

MCP-native · semantic + keyword search · real-time sync · self-hostable · source-available · Elixir/Phoenix

Connect · Quickstart · Self-host · MCP · API · Architecture · Plugin · Discord

Your notes stay plain markdown that you and your AI assistants both read and write. Pairs with the Engram Obsidian Sync plugin to sync your whole vault.

Connect

Nothing to install. Point any MCP client at the hosted server and sign in when prompted (OAuth):

https://mcp.engram.page

• Claude Code: claude mcp add --transport http engram https://mcp.engram.page
• Claude.ai / ChatGPT: add a custom connector with the URL above.
• Cursor: {"mcpServers": {"engram": {"url": "https://mcp.engram.page"}}} in ~/.cursor/mcp.json
• VS Code: {"servers": {"engram": {"type": "http", "url": "https://mcp.engram.page"}}} in .vscode/mcp.json

More clients: MCP docs.

Self-Host (Docker Compose)

Don't want to run the commands yourself? Open the Quickstart docs, select the whole page, and paste it into your AI assistant — it's written top-to-bottom as imperatives the AI can execute in order.

Otherwise:

git clone https://github.com/engram-app/Engram.git
cd Engram
cp .env.example .env       # then fill in the three secrets at the top
docker compose up -d

App at http://localhost:4000. Migrations run on boot. Only port 4000 is host-exposed; everything else stays on the private Docker network.

Large vaults? Enable MinIO for S3-style attachments: docker compose --profile s3 up -d — see storage docs.

Better embeddings? Switch to Voyage AI in .env — see embeddings docs.

Full self-host documentation

Topic	Link
Quickstart	https://engram.page/docs/self-host/quickstart/
Environment vars	https://engram.page/docs/self-host/environment-variables/
Encryption & keys	https://engram.page/docs/self-host/encryption/
Backup & restore	https://engram.page/docs/self-host/backup-restore/
Upgrades	https://engram.page/docs/self-host/upgrade/
Troubleshooting	https://engram.page/docs/self-host/troubleshooting/
Architecture	https://engram.page/docs/self-host/architecture/
MCP setup	https://engram.page/docs/mcp/
HTTP API	https://engram.page/docs/api/

Community

Questions, ideas, or bug reports? Join us on Discord.

Contributing

Local dev setup, tests, and PR rules: see CONTRIBUTING.md.

License

Dual-licensed:

• PolyForm Small Business 1.0.0 — free for organizations under $1M USD prior-year revenue and < 100 employees + contractors.
• Commercial License — required for larger orgs. See LICENSE-COMMERCIAL.md or email [email protected].

External contributions sign the Engram CLA. See CONTRIBUTING.md.

Security

See SECURITY.md for vulnerability disclosure. Self-host LAN deployments are out of scope of our published SLA — security depends on the operator's network and infra.

Copyright (c) 2026 Rasbandit Software Solutions LLC d/b/a Engram.