Setting Up Notion with Claude Code

Step 1 — Create a Notion internal integration

1. Go to https://www.notion.so/profile/integrations/internal
2. Click "Internal integrations" under Build in the left panel.
3. Create new integration. Name it (e.g. "Claude Agents"),
4. Click Save → copy the Internal Integration Secret token

Step 2 — Share your databases with the integration

1. Open the Notion database you want to post to
2. Click ... (top right) → Connections → find your integration → connect it
3. Copy each database ID from the URL — it's the string after the last / and before ?

e.g. notion.so/workspace/abc123def456?v=...

Copy-paste prompt for Claude Code Connect me to Notion so my agents can post cards to my databases. My Notion internal integration token: YOUR_TOKEN I have already shared my databases with the integration. Steps: 1. For each database I give you, call GET https://api.notion.com/v1/databases/DATABASE_ID (with Authorization: Bearer YOUR_TOKEN and Notion-Version: 2022-06-28) to discover the database name and all property names + allowed values 2. Save everything to ~/.claude/memory/reference_notion_api.md in this format: - Token and API version - Each database: name, ID, and its property names/values - Note that content goes in children paragraph blocks, not property fields 3. Test by posting a card to each database with: - A test title - Status set to "Not started" (or whatever the first status option is) - One paragraph block in children saying "Connection test" Confirm each card appears in Notion. My database IDs: - DATABASE_NAME_1: DATABASE_ID_1 - DATABASE_NAME_2: DATABASE_ID_2 (add as many as needed)