Notion Access Quick Reference

Status: WORKING (verified 2026-06-26)

MCP Tool

The Notion MCP uses ONE tool: notion_execute All operations are called as: notion_execute({"operation": "<op_name>", ...params})

To discover operation schemas: notion_describe({"operation": "search_pages"})

Verified Accessible Databases

Common Operations

# Search for pages
notion_execute: operation=search_pages, query="...", pageSize=10

# Get a specific page
notion_execute: operation=retrieve_a_page, page_id="<id>"

# Get page as markdown
notion_execute: operation=get_page_markdown, page_id="<id>"

# Query the Easier Agency wiki database
notion_execute: operation=query_a_database, database_id="86b9c355-cc0c-4438-b964-beb0141ecab9"

# Query API Keys database  
notion_execute: operation=query_a_database, database_id="abac2b0c-eea2-4e0e-82f2-3951dadd8487"

Getting API Keys

1. notion_execute: operation=query_a_database, database_id="abac2b0c-eea2-4e0e-82f2-3951dadd8487"
2. Filter results by Service field for the service you need and Status = "Active"
3. Read the API Key field

~~STALE: DO NOT USE~~

eb7df9ac-6a51-49a1-8af5-5fcae6ff2674 — wiki container ID, returns object_not_found, was never accessible via the Notion API. Ignore any reference to this ID.

Integration Details

• Bot name: Hermes
• Workspace: Stratton Digital Notion (43b8b994-1763-4750-a0c6-62a2abea2ec3)
• Token: stored in data/config.yaml under mcp_servers.notion.env.OPENAPI_MCP_HEADERS
• Owner type: workspace (full internal integration)

Navigating the Easier Agency Wiki

DO NOT use search_pages to find wiki content. It returns scattered results from across the entire workspace and requires manual parent filtering. It wastes turns and causes confusion.

CORRECT approach — query the database directly:

# Step 1: Get all wiki entries
notion_execute: operation=query_a_database, database_id="86b9c355-cc0c-4438-b964-beb0141ecab9"
# Results have a "Page" title property — pick the entry you need by title

# Step 2: Read a page's block content
notion_execute: operation=retrieve_block_children, block_id="<page_id_from_step_1>"

# Step 3: Read as markdown (preferred if available)
notion_execute: operation=get_page_markdown, page_id="<page_id_from_step_1>"

Use search_pages only when you genuinely don't know which database holds the content.