add-skill-notion

Add Notion

Configures Notion API access for agent containers, enabling reading and updating Notion pages and databases.

Preflight

Before installing, verify NanoTars is set up:

[ -d node_modules ] && echo "DEPS: ok" || echo "DEPS: missing"
docker image inspect nanoclaw-agent:latest &>/dev/null && echo "IMAGE: ok" || echo "IMAGE: not built"
if grep -q "ANTHROPIC_API_KEY\|CLAUDE_CODE_OAUTH_TOKEN" .env 2>/dev/null || [ -f "$HOME/.claude/.credentials.json" ]; then echo "AUTH: ok"; else echo "AUTH: missing"; fi

If any check fails, tell the user to run /nanotars-setup first and stop.

Prerequisites

• A Notion account with pages you want the agent to access

Install

1. Create a Notion internal integration:

   • Go to https://www.notion.so/my-integrations
   • Click New integration
   • Select the workspace to connect
   • Enable capabilities: Read content, Update content, Insert content
   • Click Submit and copy the Internal Integration Secret (starts with ntn_)
   • For each page the agent should access: open page > ... > Connections > add your integration

2. Add to .env:

   echo 'NOTION_API_KEY=YOUR_KEY_HERE' >> .env
   

3. Plugin Configuration -- Ask the user which groups should have access to Notion:

   • All groups (default) -- every group's agent can read and update Notion pages
   • Specific groups only -- e.g., only main

   If the user wants to restrict access, update plugins/notion/plugin.json after copying (step 4) to set "groups" to the list of group folder names:

   "groups": ["main"]
   

   If all groups (or the user doesn't care), leave as "groups": ["*"].

   Restricting access means only those groups' agents will have Notion tools. Other groups won't see the Notion API or credentials.

   Also ask about channel types. If the user wants this plugin available on all channel types (WhatsApp, Discord, etc.), leave "channels": ["*"]. To restrict, set "channels" to specific types (e.g., ["whatsapp"]). Most users will want the default.

4. Copy plugin files:

   cp -r ${CLAUDE_PLUGIN_ROOT}/files/ plugins/notion/
   

5. Rebuild and restart:

   npm run build
   nanotars restart  # or launchctl on macOS
   

Verify

Test the token:

source .env
curl -s "https://api.notion.com/v1/users/me" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2022-06-28" | python3 -c "
import sys, json
r = json.load(sys.stdin)
if 'id' in r:
    print(f'OK - {r.get(\"name\", \"connected\")}')
else:
    print(f'FAILED - {r}')
"

Existing Installation (Per-Group Credentials)

If this plugin is already installed and you want different credentials for a specific group (e.g., a work account for one group, personal for another):

1. Check which groups exist:

   ls -d groups/*/
   

2. Ask the user which group should get separate credentials.

3. Collect the new Notion API key for that group.

4. Write to the group's .env file (creates if needed):

   echo 'NOTION_API_KEY=ntn_...' >> groups/{folder}/.env
   

   These values override the global .env for that group's containers only.

5. Restart NanoTars:

   nanotars restart
   

Remove

1. rm -rf plugins/notion/
   

2. Remove NOTION_API_KEY from .env
3. Rebuild and restart