Doc no. SK-404DatasheetRev 2026.11Sheet 2.10 of 4
Odysseus Notion Skill
Read-only Notion tool and skill for Odysseus: a local model searches and reads your workspace live, and nothing is cached to disk.
Active
Source on GitHub
Built for Odysseus
$ pytest -v
Block diagram
Characteristics
| MCP tool | Exposes manage_notion with four explicit read-only actions: search, read, query and ping |
|---|---|
| Access control | Strictly read-only by construction: no write endpoint exists, and the HTTP client refuses non-read methods |
| Privacy & cache | Never persists workspace pages to disk; keeps responses briefly in a 45 s in-memory cache |
| Test suite | 34 offline pytest unit tests run against a mock Notion API with zero network or API token required |
| Requires | An Odysseus checkout and a Notion internal integration token restricted to "Read content" |
Overview & build notes
Gives local-model agents inside Odysseus live visibility into a personal Notion workspace without syncing secrets or private notes to disk.
The bridge splits cleanly into two parts: mcp_servers/notion_server.py enforces read-only HTTP calls and short-lived in-memory caching, while notion/notion-search/SKILL.md guides tool selection and parameter shaping so smaller local models call search, read and query reliably.
All edge cases — recursive block flattening, database filter serialization and pagination — are verified offline with 34 pytest tests against a fake Notion transport.
Files & artifacts
| Kind | File | Details | Size |
|---|---|---|---|
| Source | mcp_servers/notion_server.py | Read-only MCP tool server with 45 s memory cache on GitHub | GitHub |
| Skill | notion/notion-search/SKILL.md | Agent instructions for query construction and tool routing on GitHub | GitHub |
| Guide | INTEGRATION.md | Step-by-step wiring guide into Odysseus Docker Compose and .env | GitHub |
| Tests | tests/ | 34 offline unit tests against a mock Notion API on GitHub | GitHub |