Engram Notion MCP - Semantic Memory for AI Agents

Engram Notion MCP is a powerful Model Context Protocol (MCP) server that gives your AI agents a permanent, semantic memory. It seamlessly integrates with Notion to store, retrieve, and organize information, turning your workspace into an intelligent knowledge base.

🧠 Why Engram? AI Agents often suffer from amnesia. Engram solves this by providing a persistent memory layer backed by Notion's robust database structure.

📦 Features

Notion Integration

Semantic Memory (SQLite)

Operations

🛠 Configuration

To use Engram Notion MCP, you need to set up your environment variables.

💡 Quick Setup Tips

🔑 How to get Notion API Key

1. Go to Notion My Integrations.
2. Click New integration.
3. Name it (e.g., "Engram Notion MCP") and submit.
4. Copy the Internal Integration Secret. this is your NOTION_API_KEY.

🤖 How to get Telegram Bot Token & Chat ID

1. Bot Token:

   • Open Telegram and search for @BotFather.
   • Send the command /newbot.
   • Follow the prompts to name your bot.
   • Copy the HTTP API Token.

2. Chat ID:

   • Search for @userinfobot in Telegram.
   • Click Start or send /start.
   • It will reply with your Id. Copy this number.

Configuration Patterns

1. Minimal Setup (Flexible / Unbound)

You can omit NOTION_PAGE_ID to keep the agent "unbound". It will force the agent to ask for a destination or search for one.

"env": {
  "NOTION_API_KEY": "secret_your_key_here"
}

2. Multi-Page Support

You don't need to configure an array of IDs. Engram relies on Notion's native permissions. To give the agent access to multiple specific pages:

1. Open any page in Notion.
2. Click the ... (three dots) menu (top-right) -> Connections.
3. Look for the name you gave your integration (e.g., "Engram Notion MCP").
4. Once connected, the agent can automatically see this page using the list_accessible_pages tool.
5. Repeat this for any other page you want the agent to see.

🔌 Installation & Client Setup Instructions

{
  "mcpServers": {
    "engram-notion-mcp": {
      "command": "bunx",
      "args": ["engram-notion-mcp"],
      "env": {
        "NOTION_API_KEY": "secret_your_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "engram-notion-mcp": {
      "command": "npx",
      "args": ["-y", "engram-notion-mcp"],
      "env": {
        "NOTION_API_KEY": "secret_your_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "engram-notion-mcp": {
      "command": "uvx",
      "args": ["engram-notion-mcp"],
      "env": {
        "NOTION_API_KEY": "secret_your_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "engram-notion-mcp": {
      "command": "pipx",
      "args": ["run", "engram-notion-mcp"],
      "env": { ... }
    }
  }
}

Where to put it:

• 🖥️ Desktop Apps (Claude Desktop): claude_desktop_config.json

• 🆚 VS Code / Cursor / Windsurf: User Settings (settings.json).

• Cline / Roo Code: Extension Settings -> MCP Servers.

• Kilo Code: .kilo/config.json.

• ⌨️ Gemini CLI:

  Bun (Recommended)

  gemini mcp add engram-notion-mcp bunx "engram-notion-mcp" -e NOTION_API_KEY=<your_secret_key>
  

  Node.js - NPX (Standard)

  gemini mcp add engram node "npx engram-notion-mcp" -e NOTION_API_KEY=<your_secret_key>
  

💬 Support & Feedback

If you face any issues or have suggestions, please feel free to:

• Open an issue on this GitHub Repository.
• Reach out to me directly via my GitHub profile.

Quick Links

This MCP tool is published as a package on NPM and PyPI.

• Bun / Node.js Package on NPM
• Python Package on PyPI