Guide to setting up third-party authentication for a Notion Worker. Covers brokered credentials for external-service API keys / personal access tokens, OAuth, and plaintext environment secrets only when worker code needs the value. Use when the worker needs credentials for a non-Notion API, not for Notion API tokens or `ntn login`.
Install
npx skills add makenotion/notion-cookbook --skill auth-guidenpx skills add makenotion/notion-cookbook --skill auth-guide -a claude-code -gnpx skills add makenotion/notion-cookbook --skill auth-guide -a codex -ggemini skills install https://github.com/makenotion/notion-cookbook.git --path workers/agents/skills/auth-guidegh skill install makenotion/notion-cookbook auth-guidegit clone --depth 1 https://github.com/makenotion/notion-cookbook /tmp/makenotion__notion-cookbook
mkdir -p ~/.claude/skills ~/.agents/skills
cp -R /tmp/makenotion__notion-cookbook/workers/agents/skills/auth-guide ~/.claude/skills/auth-guide # Claude Code
cp -R /tmp/makenotion__notion-cookbook/workers/agents/skills/auth-guide ~/.agents/skills/auth-guide # Codex, Cursor, Gemini CLI, Copilot, OpenCode