Engram Notion Mcp — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited Engram Notion Mcp (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
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.
| Feature | Tool Name | Description |
|---|---|---|
| Page Creation | create_page | Create new pages with content. Auto-chunks large text to avoid limits. |
| Page Updates | update_page | Append content to existing pages. Auto-chunks large text. |
| Logging | log_to_notion | Fast logging wrapper for appending notes/logs. |
| Reading | read_page_content | Read and parse page content into Agent-friendly text. |
| Databases | list_databases | detailed list of accessible databases. |
| Querying | query_database | Query databases with filters to find specific items. |
| Organization | list_sub_pages | List pages within a parent page. |
| Cleanup | delete_block | Archive/Delete blocks or pages. |
| Feature | Tool Name | Description |
|---|---|---|
| Store Facts | remember_fact | Saves key info to internal vector-like storage. |
| Search | search_memory | Full-text search over stored memories. |
| Recall | get_recent_memories | Retrieve the latest context/facts. |
| Feature | Tool Name | Description |
|---|---|---|
| Alerts | send_alert | Send push notifications via Telegram. |
To use Engram Notion MCP, you need to set up your environment variables.
| Variable | Required | Description |
|---|---|---|
NOTION_API_KEY | Yes | Your Notion Internal Integration Token (secret_...). |
NOTION_PAGE_ID | No | Default Page ID for creating pages if no parent is specified. |
TELEGRAM_BOT_TOKEN | No | For send_alert tool. |
TELEGRAM_CHAT_ID | No | For send_alert tool. |
AGENT_MEMORY_PATH | No | Custom path for the SQLite memory database. |
### 💡 Quick Setup Tips <details> <summary> <strong>🔑 How to get Notion API Key</strong> </summary>
>
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. </details>>
<details> <summary> <strong>🤖 How to get Telegram Bot Token & Chat ID</strong> </summary>
>
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. </details>>
#### 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:
list_accessible_pages tool.<details open> <summary> <h3 style="display: inline-block;"> ⚡ Recommended (Fastest) - Bun</h3> </summary>
Use bunx to run the server with native performance (bun:sqlite).
Add this to your claude_desktop_config.json or mcp.json.
Config using `bunx` (Recommended):
{
"mcpServers": {
"engram-notion-mcp": {
"command": "bunx",
"args": ["engram-notion-mcp"],
"env": {
"NOTION_API_KEY": "secret_your_key_here"
}
}
}
}</details>
<details> <summary> <h3 style="display: inline-block;"> 🐢 Standard - Node.js (NPX)</h3> </summary>
Works with any standard Node.js environment (better-sqlite3).
Add this to your claude_desktop_config.json or mcp.json.
Config using `npx` (Standard):
{
"mcpServers": {
"engram-notion-mcp": {
"command": "npx",
"args": ["-y", "engram-notion-mcp"],
"env": {
"NOTION_API_KEY": "secret_your_key_here"
}
}
}
}</details>
<details> <summary> <h3 style="display: inline-block;"> 🐍 Alternative - Python (UVX / PIPX)</h3> </summary>
If you prefer uvx or pipx or have strict Python environments:
Add this to your claude_desktop_config.json or mcp.json.
Config using `uvx` (Alternative):
{
"mcpServers": {
"engram-notion-mcp": {
"command": "uvx",
"args": ["engram-notion-mcp"],
"env": {
"NOTION_API_KEY": "secret_your_key_here"
}
}
}
}Config using `pipx` (Alternative):
{
"mcpServers": {
"engram-notion-mcp": {
"command": "pipx",
"args": ["run", "engram-notion-mcp"],
"env": { ... }
}
}
}</details>
Where to put it:
settings.json)..kilo/config.json.<details> <summary> <strong>Bun (Recommended)</strong> </summary>
gemini mcp add engram-notion-mcp bunx "engram-notion-mcp" -e NOTION_API_KEY=<your_secret_key></details>
<details> <summary> <strong>Node.js - NPX (Standard)</strong> </summary>
gemini mcp add engram node "npx engram-notion-mcp" -e NOTION_API_KEY=<your_secret_key></details>
If you face any issues or have suggestions, please feel free to:
This MCP tool is published as a package on NPM and PyPI.
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.