Edit: quick_reference_notion_access.md

Note Content (Markdown)

# 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

| Database | ID | Purpose |
|---|---|---|
| Easier Agency wiki | `86b9c355-cc0c-4438-b964-beb0141ecab9` | Main knowledge base |
| API Keys | `abac2b0c-eea2-4e0e-82f2-3951dadd8487` | Service credentials |
| Software Logins | `d6f9882d-56c7-493e-a026-8b6012e1b30b` | Platform accounts |

## 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.