Self-hosting setup

Overview

Nock requires three external integrations: a Slack app (for slash commands and event listening), a Notion integration (for CRM access), and an Anthropic API key (for the AI agent). Optionally, Supabase is used to store the connection between your Slack workspace and Notion, and Perplexity is used for research in #agent mode.

1. Create the Notion integration

Nock accesses your Notion workspace via an internal integration token.

1. Go to https://www.notion.so/profile/integrations and click New integration.
2. Give it a name (e.g. Nock CRM) and select your workspace.
3. Under Capabilities, enable:

• Read content
• Update content
• Insert content

1. Click Save. Copy the Internal Integration Secret — this is your NOTION_TOKEN.
2. In Notion, open each database you want Nock to access, click the ... menu → Connections, and add your integration.

Nock needs access to all databases it should be able to read or write. Run /nock refresh settings after granting access to new databases.

2. Create the Slack app

Go to https://api.slack.com/apps and click Create New App → From scratch. Name it Nock and select your workspace.