README.md
51 lines · 1.6 KB · Markdown@kody/notion-mcp
Intent
Wrap the official Notion MCP server (kody.mcp["notion"]) so
onboarding is add-server-and-authorize. This package is the MCP helper.
The existing OAuth/API package @kody/notion stays separate.
This listing is meant to be forked. After you fork, connect your
Notion workspace. Do not treat the live @kody/notion-mcp connection
as yours.
Share this listing as https://kody.codes/@kody/notion-mcp
What it does
- Probe whether the Notion MCP server is connected (or report setup)
- Search Notion pages the authorizing user can already see
- Prefer official MCP over registering a custom Notion OAuth app
Prerequisites / setup
Preferred: add the official Notion MCP server, then authorize it.
await kody.mcpServerAdd({
name: 'notion',
url: 'https://mcp.notion.com/mcp',
})Open the returned authUrl. Helpers then call kody.mcp["notion"]. The
MCP server name stays notion. The -mcp suffix is only the Kody
package identity.
Do not register a Notion OAuth app for the one-click path. For OAuth or
API-key helpers, use @kody/notion.
Agents: see AGENTS.md for import paths and smoke checks.
Done when
- Notion MCP server
notionis added and authorized - Smoke test reports MCP connected (or clear setup /
@kody/notionfallback) searchreturns pages the user can already see
Branding
community-icon.png is Notion's official mark. Notion is a trademark of
Notion Labs, Inc. This package is not affiliated with or endorsed by Notion.
Keep the MIT license and this Intent section when forking.