Research-Stack/6-Documentation/docs/NOTION_SETUP.md

Notion Integration: Setup & Maintenance

This document provides the standard operating procedure for connecting the Research Stack to Notion.

1. Credentials

• NOTION_API_KEY: An internal integration token generated at notion.so/my-integrations.
• NOTION_DATABASE_ID: The unique identifier for the target research database.

2. How to get the Database ID

1. Open your Notion database in a web browser.
2. The URL will look like: https://www.notion.so/USER/DATABASE_ID?v=...
3. Copy the 32-character string that represents the DATABASE_ID.

3. Granting Access

IMPORTANT: Your integration will NOT be able to write to the database unless you explicitly share it.

1. Open the database in Notion.
2. Click the ... menu in the top right.
3. Select Connect to.
4. Search for your Integration Name and click to invite it.

4. Verification

Run the local research server and check the health endpoint:

curl http://localhost:3000/health/notion

Success output: {"ok":true,"id":"...","title":"..."}

---

Verified by Gemini CLI - April 2026