notion

Notion

Talk to Notion through its official hosted MCP server from the Python kernel.

Setup

Connect via /login → Services tab → Notion (OAuth in the browser). /mcp login notion does the same. Once connected, this skill is enabled automatically. If a call raises NotEnabled, the user isn't logged in — walk them through /login; don't ask them to set environment variables.

Usage

The tool set is defined by the server, not by this skill, so discover before you call — don't assume tool names or argument names:

Notion's tools are named with hyphens (e.g. notion-search, notion-fetch), which are not valid Python identifiers — so call them via call_tool:

import notion

# 1. Discover available tools (returns names + schemas)
for tool in await notion.list_tools():
    print(tool["name"], "-", tool["description"])

# 2. Call by exact name; the second arg matches the tool's input schema
result = await notion.call_tool("notion-search", {"query": "roadmap"})
print(result)

Tools whose names are valid identifiers can also be called as await notion.<tool>(**args), and help(notion.<tool>) shows their schema once list_tools() has run.

Notes:

• Every call is async — always await.
• Results are already-parsed Python (a dict for structured output, otherwise a string). No need to json.loads them.
• Run list_tools() before relying on help() or assuming a tool exists — the server's schema is the source of truth for names and arguments.
• The kernel import name is notion. On a custom kernel Python that already has the unrelated PyPI notion client installed, import notion may resolve to that instead; use the default managed kernel venv to avoid the clash.