Engram

The permanent and semantic memory layer for AI agents.

Introduction

Engram transforms your Notion workspace into a living, cognitive substrate for your AI agents.

Why Engram?

According to neuropsychology, an engram is a unit of cognitive information imprinted in a physical substance, theorized to be the means by which memories are stored. This MCP server acts as that physical bridge, allowing your AI to:

• Encode Information: Instantly store facts in a local vector-like "synaptic" database.
• Stimulate Recall: Semantically search your entire knowledge base to retrieve context.
• Imprint Knowledge: Create and edit rich Notion pages (markdown, tables, mermaid) as permanent memory traces.

Features

Prerequisites

Before using this tool, ensure you have Python 3.10 or higher installed.

# 1. Install pipx (user scope)
python3 -m pip install --user pipx

# 2. Add to PATH
python3 -m pipx ensurepath

# 3. Verify
pipx --version

Configuration

1. Notion Setup

• Integration Token: Go to Notion My Integrations -> New Integration -> Copy the "Internal Integration Secret".
• Page ID: Open the Notion page you want to use as the root. Copy the alphanumeric ID from the URL. Don't forget to connect this page to your specific integration.

2. Environment Variables

Client Setup

Add the following to your MCP client configuration (e.g., claude_desktop_config.json for Claude Desktop).

Recommended: uv

{
  "mcpServers": {
    "engram": {
      "command": "uvx",
      "args": ["engram-mcp"],
      "env": {
        "NOTION_API_KEY": "secret_...",
        "NOTION_PAGE_ID": "page_id_...",
        "TELEGRAM_BOT_TOKEN": "bot_token_...",
        "TELEGRAM_CHAT_ID": "chat_id_...",
        "AGENT_MEMORY_PATH": "/path/to/db"
      }
    }
  }
}

{
  "mcpServers": {
    "engram": {
      "command": "pipx",
      "args": ["run", "engram-mcp"],
      "env": {
        "NOTION_API_KEY": "secret_...",
        "NOTION_PAGE_ID": "page_id_...",
        "TELEGRAM_BOT_TOKEN": "bot_token_...",
        "...": "..."
      }
    }
  }
}

License

This project is licensed under the MIT License.