notion
Search Notion and read/create/update pages and databases via Notion's official hosted MCP server. Tools are auto-discovered from the server at runtime.
- License 许可
- MIT
- 最近更新
- 2026-11-03
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- notion
- description
- Search Notion and read/create/update pages and databases via Notion's official hosted MCP server. Tools are auto-discovered from the server at runtime.
02 资源文件 2
- 其他pyproject.toml373 B
- 脚本src/notion/__init__.py738 B
03 SKILL.md 正文
Notion
Talk to Notion through its official hosted MCP server from the IPython 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— alwaysawait. - Results are already-parsed Python (a
dictfor structured output, otherwise a string). No need tojson.loadsthem. - Run
list_tools()before relying onhelp()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 customPRIME_AGENT_KERNEL_PYTHONthat already has the unrelated PyPInotionclient installed,import notionmay resolve to that instead; use the default managed kernel venv to avoid the clash.
04 同仓库更多 Skills
valid-skill
A valid skill for testing purposes.
unknown-field
A skill with an unknown frontmatter field.
nested-child
Nested skill should be ignored.
root-skill-preferred
Root skill should win.
python-skill
A Python-backed skill for testing.
python-package-missing
A Python skill missing its import package.