{"slug":"connect-your-ai-to-notion","url":"https://agentics.page/recipes/connect-your-ai-to-notion","title":"Connect your AI assistant to your Notion workspace","problem":"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.","audience":"anyone","skills":[{"slug":"notion","url":"https://agentics.page/skills/notion","api":"https://agentics.page/api/skills/notion"}],"clients":["claude-desktop","claude-code","cursor","vscode"],"timeMinutes":3,"steps":[{"title":"Add Notion as a connector","body":"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."},{"title":"Sign in with your browser","body":"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."},{"title":"Ask about your workspace","body":"Paste the prompt below, adjusted to something that actually exists in your Notion."}],"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).","expectedResult":"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.","troubleshooting":[{"q":"The sign-in window never appears.","a":"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."},{"q":"It can't find pages that definitely exist.","a":"During OAuth you selected which pages are shared. Re-run the connector setup and grant access to the relevant pages or the whole workspace."},{"q":"Is my Notion data safe?","a":"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."}],"lastReviewed":"2026-06-10","verified":null}