Skip to content

feat(notion-mcp): add Notion MCP integration plugin - #160

Open
Jommmain wants to merge 1 commit into
zai-org:mainfrom
Jommmain:feat/notion-mcp-plugin
Open

Jommmain wants to merge 1 commit into
zai-org:mainfrom
Jommmain:feat/notion-mcp-plugin

Conversation

@Jommmain

@Jommmain Jommmain commented Nov 3, 2026

Copy link
Copy Markdown

Plugin type

Standard plugin — affected manifest name: notion-mcp

What user problem does this solve?

ZCode currently has no Notion integration in the marketplace. Users want the agent to read/create/update Notion pages and databases, work with page comments, browse page version history, and search/read Notion chat session history.

This plugin declares the official remote Notion MCP server (https://mcp.notion.com/mcp, ~70 tools incl. notion-search, notion-fetch, notion-create-pages, notion-get-comments, notion-search-sessions, notion-get-version-changes, calendar and meeting notes) and ships a setup skill.

One caveat is documented up front: the Notion MCP server only whitelists a fixed list of OAuth client names and ZCode is not on it, so the out-of-the-box connect fails at client registration. The setup skill points to a small MIT-licensed helper (https://github.com/Jommmain/zcode-notion-mcp) that runs the OAuth flow under an accepted client name and injects the tokens into ZCode's encrypted credential store (~/.zcode/v2/credentials.json, with a backup copy). After a one-time authorization (and re-run on token expiry), the MCP server works natively.

Visible behavior and testing

  • repository validation → OK (53 plugins on this branch)
  • zip build for this plugin → 4845 bytes artifact (the full dist build still requires the UI-plugin pnpm build step, unchanged by this PR)
  • git diff --check → clean
  • Live end-to-end: the OAuth helper was run against https://mcp.notion.com/mcp on macOS; the connection verified with listTools() (72 tools) and the tools were exercised from ZCode

Version and marketplace registration

  • notion-mcp 0.1.0, registered in marketplace.json (external_plugins/notion-mcp), category productivity
  • Manifest and marketplace entry descriptions (en + zh-CN) are identical

Dependencies, network access, permissions, side effects

  • Network: ZCode connects to https://mcp.notion.com after install; the optional one-time helper additionally runs a local callback server on localhost:3000 during authorization
  • Service dependency: a Notion account; the connection only sees pages the user shares during authorization
  • File writes: none by the plugin; the helper writes only ~/.zcode/v2/credentials.json (+ .backup)
  • No hooks, no commands, no bundled binaries

Licensing / provenance

  • Plugin authored for this submission (MIT, consistent with the repo)
  • Third-party services: the Notion MCP server (operated by Notion Labs, subject to Notion ToS); the optional helper https://github.com/Jommmain/zcode-notion-mcp (MIT, depends on @modelcontextprotocol/sdk, MIT) — referenced, not vendored

@panda920

panda920 commented Nov 3, 2026

Copy link
Copy Markdown
Collaborator

✅ Internal validation passed. A ZCode maintainer will review the change next; after acceptance, release checks run separately and this PR is closed automatically.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants