Recipe · ~3 min · no coding required

Connect your AI assistant to your Notion workspace

Your notes, docs, and project pages live in Notion — and you want to ask your assistant about them ("what's the status of project X?") and have it create or update pages for you.

You need

  • · An AI app that supports skills: Claude Desktop, Claude Code, Cursor, VS Code — don't have one yet?
  • · The Notion skill (no API key)
  • · About 3 minutes

Step by step

  1. 1
    Add Notion as a connector

    This skill is hosted by Notion itself — there is nothing to install on your machine and no API key. In Claude Desktop: Settings → Connectors → Add custom connector, then paste the URL from the widget below. In Claude Code, Cursor, or VS Code use the one-line command/deep link.

  2. 2
    Sign in with your browser

    On first use a browser window opens and asks you to authorize access to your workspace (OAuth). You choose which pages the assistant may see.

  3. 3
    Ask about your workspace

    Paste the prompt below, adjusted to something that actually exists in your Notion.

Install the Notion skill

You need: an AI app that supports skills (pick yours above) · Nothing to install — this skill is hosted by the vendor. You sign in with your browser on first use.

Open Settings → Connectors → Add custom connector in Claude Desktop and paste this URL:

https://mcp.notion.com/mcp

The prompt

Search my Notion workspace for pages that mention "planning". List the five most recently edited ones with a one-line summary each, and tell me which of them look stale (not edited in over a month).

What you should see

The assistant searches your real workspace and comes back with actual page titles, edit dates, and summaries — and can follow up with "create a summary page of this" if you ask.

Last reviewed 2026-06-10

If it doesn't work

The sign-in window never appears.
Trigger the skill once (send the prompt) — the OAuth window opens on first tool use, not on install. If it still doesn't, check your default browser isn't blocking pop-ups.
It can't find pages that definitely exist.
During OAuth you selected which pages are shared. Re-run the connector setup and grant access to the relevant pages or the whole workspace.
Is my Notion data safe?
The connection runs through Notion's own hosted MCP server with the permissions you granted during sign-in — the same mechanism Notion uses for official integrations. You can revoke access anytime in Notion's settings under Connections.

Run a website? Make sure agents can read it.

Assistants with skills like these are already visiting websites on their owners' behalf. agentics checks free of charge whether yours is readable, findable, and trusted by AI agents.

Run free check →

More recipes

Let your AI assistant browse the web and compare prices for you

You want your AI assistant to actually open websites — compare prices, check availability, read pages that need a real browser — instead of telling you it cannot browse.

Let your AI assistant search and summarize files on your computer

Your documents, invoices, and contracts live in folders on your machine — and you want to ask questions about them ("find the contract that mentions X", "sum up these invoices") without uploading anything anywhere.

Give your AI assistant live web search

Your assistant answers from training data that is months old. You want it to search the web right now — news, prices, fresh documentation — and answer with sources.