Skip to main content

Connect Notion

SignalPilot can launch notebook-backed data analysis from Notion comments. In SignalPilot Cloud, the Notion integration is available under a paid subscription. If your workspace is on a free plan, upgrade before connecting Notion.

Before you start​

  • A SignalPilot subscription with Notion integrations enabled.
  • Access to the Notion workspace and pages where users will create SignalPilot requests.
  • An Anthropic API key for the SignalPilot agent.

Set up the integration​

  1. Open SignalPilot Cloud and go to Integrations.
  2. Click Connect Notion.
  3. Approve the Notion OAuth install and grant SignalPilot access to the shared workspace or teamspace area where SignalPilot should create its resources.
  4. Back in SignalPilot, choose a default project, then click Provision integration.

Provisioning creates the Notion resources SignalPilot needs:

  • A SignalPilot Integration page reused from the selected Notion area when present, or created automatically beside a visible child page when Notion exposes a page parent.
  • A SignalPilot page inside SignalPilot Integration that acts as the mention trigger.
  • A SignalPilot Requests database inside SignalPilot Integration where requests and generated notebook runs are tracked.

If Notion only exposes top-level pages and SignalPilot cannot create a sibling page, create a page named SignalPilot Integration in the shared workspace or teamspace area, share it with the SignalPilot connection, then provision again.

Add your Anthropic key​

Open a SignalPilot notebook or Notion request. If the agent panel asks for an API key, paste your Anthropic API key and save it.

SignalPilot stores the key encrypted on the server and uses it to run the analysis agent for your requests.

Trigger SignalPilot from Notion​

Open a Notion page that has SignalPilot added as a connection. If the page does not have the connection yet, use Notion's page menu to add the SignalPilot connection first.

Add a comment on that page and mention the SignalPilot agent, then write the analysis request you want SignalPilot to run:

@SignalPilot using the production warehouse connection, compare revenue by segment for Q2 and build a notebook with the supporting charts

Select the SignalPilot agent from Notion's picker. SignalPilot ignores unrelated comments and only handles events routed to the SignalPilot connection.

The Notion comment is the trigger and prompt. SignalPilot does not inspect or edit the surrounding Notion page content. It runs the analysis through SignalPilot's configured data connections and notebook infrastructure.

When the request is accepted, SignalPilot adds a Notion comment, creates a request record in SignalPilot Requests, and runs the notebook-backed analysis. You can open the generated notebook in SignalPilot, share it with teammates, and keep iterating there.

Troubleshooting​

No response in Notion

Confirm the page where you commented has SignalPilot added as a connection, and confirm your comment mentions the SignalPilot agent.

SignalPilot did not use the surrounding page content

That is expected. The integration uses Notion as a request surface for SignalPilot analysis. Put the actual analytical question, connection name, tables, metrics, or business context in the comment, then continue the work in the generated SignalPilot notebook.

Agent asks for a key

Paste your Anthropic API key in the SignalPilot agent panel. The Notion trigger can create the request, but analysis requires the agent key.

Integration page is blocked

In SignalPilot Cloud, Notion integrations are a paid subscription feature. Upgrade the workspace plan, then return to Integrations.

Video walkthrough​

Open the Notion setup walkthrough on Loom.