Skip to content

egregore-labs/egregore / .claude/skills/notion-connect

notion-connect

Verified

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.

FileKindSize
SKILL.mdskill md4.3 KB
---
name: notion-connect
description: "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."
---

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

```bash
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:

```bash
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
bash bin/telemetry.sh emit "command" '{"command":"notion-connect","transport":"mcp"}' 2>/dev/null &
```
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall