notion-connect

Use for 'connect notion', 'notion status', or 'disconnect notion' — connects the current agent runtime directly to Notion's official hosted MCP for search and fetch, or checks/revokes that connection.

SKILL.md

GitHub

Connect the current agent runtime directly to Notion's official hosted MCP.

Arguments: $ARGUMENTS (Optional: status or revoke)

When to invoke

  • "connect notion", "set up notion", "link notion" → run the connection flow
  • "notion status", "is notion connected" → status
  • "disconnect notion", "revoke notion" → revoke
  • /ingest notion also enters this flow automatically when the MCP tools are missing. Users do not need to run this skill first.

Product boundary

Notion provides the bridge. Egregore does not register a Notion OAuth app and does not receive or store the user's Notion OAuth token. The current agent runtime connects directly to https://mcp.notion.com/mcp; Notion owns the login and consent screen, and the runtime stores its own authorization.

Say this before opening the login flow:

Notion will connect directly to this agent. Egregore Labs does not receive your Notion login or token. The agent can see what your Notion account can see. Search and fetched content pass through this session; pages you approve are additionally saved as curated shared memory.

Do not claim that the MCP is read-only or limited to selected pages. Notion MCP uses the signed-in user's permissions. Normal Egregore session capture may include tool results the agent inspected. The /ingest notion review step is the boundary for what becomes a curated Notion source in shared memory.

Readiness check

First discover available tools using the runtime's tool registry:

  • Claude Code: use ToolSearch with notion.
  • Codex/OpenAI clients: search for Notion MCP tools. OpenAI may expose notion-search and notion-fetch as search and fetch.
  • Other MCP-aware runtimes: inspect the loaded tools for the Notion server.

The connection is ready when both search and fetch are available. Prefer a notion-get-self/get-self call for status when present; otherwise a small search is enough to verify access.

Setup

Use the path for the current runtime. These commands register Notion's official remote MCP only; they do not install an Egregore connector.

Claude Code

claude mcp get notion >/dev/null 2>&1 || \
  claude mcp add --transport http --scope project notion https://mcp.notion.com/mcp
claude mcp login notion

If the tools do not appear after login, say:

Notion is connected. Restart this Claude Code session, then run /ingest notion again.

Codex

Notion is optional and is not registered by a fresh Egregore installation. On an explicit connection request, register it if absent, then sign in:

codex mcp get notion >/dev/null 2>&1 || \
  codex mcp add notion --url https://mcp.notion.com/mcp
codex mcp login notion

If the tools do not appear after login, say:

Notion is connected. Restart this Codex session, then run $ingest notion again.

Pi

Pi does not provide MCP support. Do not fall back to the legacy REST connector. Say:

Notion MCP is not available in Pi yet. Open this Egregore in Claude Code or Codex to connect and import Notion pages.

Stop.

Other MCP clients

Add https://mcp.notion.com/mcp as a Streamable HTTP server named notion, then complete Notion's OAuth flow. If the client only loads new servers at startup, ask the user to restart and return to /ingest notion.

Continue into ingest

Once search and fetch are available, return directly to the calling /ingest notion flow. When this skill was invoked on its own, close with:

Connected. Run /ingest notion and tell me what you want to bring into memory.

Status

Discover the Notion tools and call notion-get-self/get-self when available. Report only connected workspace/user information returned by Notion. Do not read .egregore-state.json; MCP authorization belongs to the runtime.

Revoke

  • Claude Code: claude mcp logout notion
  • Codex: codex mcp logout notion
  • Other clients: disconnect Notion from that client's MCP settings.

Confirm:

Disconnected here. Pages already imported into Egregore memory remain until you remove them.

Telemetry, fire-and-forget:

bash bin/telemetry.sh emit "command" '{"command":"notion-connect","transport":"mcp"}' 2>/dev/null &