SK-404

Doc no. SK-404DatasheetRev 2026.11Sheet 2.10 of 4

A4

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

01

Block diagram

Odysseuslocal-model agent SKILL.mdwhen · how to call notion_serversearch · read · query Notion APIreads only · 45s mem
Fig. 1: Read-only path from agent to Notion
02

Characteristics

MCP toolExposes manage_notion with four explicit read-only actions: search, read, query and ping
Access controlStrictly read-only by construction: no write endpoint exists, and the HTTP client refuses non-read methods
Privacy & cacheNever persists workspace pages to disk; keeps responses briefly in a 45 s in-memory cache
Test suite34 offline pytest unit tests run against a mock Notion API with zero network or API token required
RequiresAn Odysseus checkout and a Notion internal integration token restricted to "Read content"
  • MCP
  • Notion API
  • Python
  • pytest
03

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.

04

Files & artifacts

KindFileDetailsSize
Sourcemcp_servers/notion_server.pyRead-only MCP tool server with 45 s memory cache on GitHubGitHub
Skillnotion/notion-search/SKILL.mdAgent instructions for query construction and tool routing on GitHubGitHub
GuideINTEGRATION.mdStep-by-step wiring guide into Odysseus Docker Compose and .envGitHub
Teststests/34 offline unit tests against a mock Notion API on GitHubGitHub

U1Notion Better Export