Notion × Claude

Assign a task.
It gets done.

A background agent for your Mac. Assign any Notion task to Claude — it picks it up within 60 seconds, does the work, and writes results back to the task page.

Set it up →
How it works
01
Assign to Claude

Open any task in your Notion database. Set the Assignee property to Claude.

02
Agent picks it up

A daemon running on your Mac polls Notion every 60 seconds. It finds the task and starts working.

03
Results in Notion

Claude executes the task and writes the output directly back to the task page. Formatted, structured, ready to use.

What to use it for
Research

"Research the top 5 competitors in the AWS co-sell space and summarise their positioning."

Writing

"Write a product brief for the onboarding feature based on the notes below."

Analysis

"Review this sprint's tasks and identify what's blocked and why."

Code

"Generate a Python script to clean and validate this CSV structure."

Requirements
Setup
01
Create a Notion integration
  • Go to notion.so/profile/integrations → New integration → Internal
  • Copy the API key — it starts with ntn_
  • Open your Tasks database → Settings → Connections → add the integration
02
Add an Assignee property

Your Tasks database needs a Select property named Assignee with an option called Claude.

03
Download and run setup
↓ Download notion-claude-agent.zip

Unzip the file, then open Terminal and run:

$ cd ~/Downloads/notion-claude-agent $ python3 setup_wizard.py

The wizard validates your key, lists your databases, and writes the config file.

04
Install the background agent
$ ./install.sh

Installs a background process that starts automatically on login and polls Notion every 60 seconds.

05
Assign your first task

Open any Notion task. Set Assignee = Claude. Done.