# Engram
MCP-native · semantic + keyword search · real-time sync · self-hostable · source-available · Elixir/Phoenix
[](https://modelcontextprotocol.io)
[](https://github.com/engram-app/Engram/commits/main)
[](https://github.com/engram-app/Engram/stargazers)
[](LICENSE)
[](https://github.com/sponsors/engram-app)
[](https://ko-fi.com/engrams_sync)
[Connect](#connect) · [Quickstart](#self-host-docker-compose) · [Self-host](https://engram.page/docs/self-host/) · [MCP](https://engram.page/docs/mcp/) · [API](https://engram.page/docs/api/) · [Architecture](https://engram.page/docs/self-host/architecture/) · [Plugin](https://github.com/engram-app/Engram-obsidian) · [Discord](https://discord.gg/NG9Vn9VcPS)
Your notes stay plain markdown that you and your AI assistants both read and
write. Pairs with the
[Engram Obsidian Sync](https://github.com/engram-app/Engram-obsidian) 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](https://engram.page/docs/mcp/).
## Self-Host (Docker Compose)
**Don't want to run the commands yourself?** Open the
[Quickstart docs](https://engram.page/docs/self-host/quickstart/), 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:
```bash
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 . 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](https://engram.page/docs/self-host/environment-variables/#storage).
**Better embeddings?** Switch to Voyage AI in `.env` — see
[embeddings docs](https://engram.page/docs/self-host/environment-variables/#embeddings).
### Full self-host documentation
| Topic | Link |
|---|---|
| Quickstart | |
| Environment vars | |
| Encryption & keys | |
| Backup & restore | |
| Upgrades | |
| Troubleshooting | |
| Architecture | |
| MCP setup | |
| HTTP API | |
## Community
Questions, ideas, or bug reports? Join us on [Discord](https://discord.gg/NG9Vn9VcPS).
## Contributing
Local dev setup, tests, and PR rules: see [CONTRIBUTING.md](./CONTRIBUTING.md).
## License
Dual-licensed:
- **[PolyForm Small Business 1.0.0](./LICENSE)** — free for organizations
under $1M USD prior-year revenue and < 100 employees + contractors.
- **Commercial License** — required for larger orgs. See
[LICENSE-COMMERCIAL.md](./LICENSE-COMMERCIAL.md) or email
`support@engram.page`.
External contributions sign the [Engram CLA](./.github/CLA.md). See
[CONTRIBUTING.md](./CONTRIBUTING.md).
## Security
See [SECURITY.md](./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.