notion-install-auth

# Notion Install & Auth ## Overview Set up the official Notion SDK and configure authentication for internal integrations. The Node.js SDK is `@notionhq/client` (npm) and the Python SDK is `notion-client` (pip). Both wrap the Notion API at `https://api.notion.com/v1` using API version `2022-06-28`. ## Prerequisites - Node.js 18+ or Python 3.8+ - Package manager (npm, pnpm, yarn, or pip) - A Notion account (free or paid) - Access to [My Integrations](https://www.notion.so/my-integrations) dashboard ## Instructions ### Step 1: Create Integration and Install SDK Create an internal integration at https://www.notion.so/my-integrations: 1. Click **New integration** 2. Name it, select the workspace, and choose capabilities (Read content, Update content, Insert content) 3. Copy the **Internal Integration Secret** (starts with `ntn_` or `secret_`) Install the SDK: ```bash # Node.js / TypeScript (official SDK) npm install @notionhq/client # Python (official SDK) pip install notion-client ``` ### Step 2: Configure Authentication Store the token in environment variables -- never hardcode it: ```bash # Set environment variable export NOTION_TOKEN="ntn_your_integration_secret_here" # Or add to .env file (add .env to .gitignore) echo 'NOTION_TOKEN=ntn_your_integration_secret_here' >> .env ``` **Share pages with your integration:** In Notion, open the page or database you want to access. Click the `...` menu, select **Connections**, and add your integration. Without this step...