Step 1: Navigate to the Integrations Page
Log in to your ClawStaff dashboard and click Integrations in the left sidebar. Find Notion under the Productivity category. The Notion integration card shows a summary of capabilities including reading pages, creating new content, querying databases, and syncing knowledge bases for your Claws.
If this is your first integration, you will see a brief onboarding tip explaining how integrations work with your Claws and ClawCage environments.
Step 2: Click “Add Notion”
Click the Add Notion button on the integration card to start the OAuth flow. A modal will appear describing the permissions ClawStaff needs to interact with your Notion workspace, including reading page content, inserting new blocks, and querying database entries. These permissions allow your Claws to use Notion as a knowledge base and a destination for generated content.
Click Continue to Notion to be redirected to Notion’s authorization page. Make sure you are logged into the correct Notion workspace before proceeding, as the authorization will be tied to whichever workspace is active.
Step 3: Authorize ClawStaff in Notion
On the Notion authorization page, you will see the ClawStaff integration requesting access to your workspace. Notion uses a granular permissions model where you explicitly choose which pages and databases the integration can access. By default, no pages are shared; you must actively select them.
Use the page picker to select the pages, databases, and workspaces you want your Claws to access. You can grant access to an entire section of your workspace or pick individual pages. Click Allow access to complete the authorization and return to the ClawStaff dashboard.
Step 4: Configure Page and Database Access
After the OAuth flow completes, the ClawStaff dashboard will display the pages and databases you shared during authorization. Review the list to make sure everything you need is included. For each page or database, you can set access permissions to read-only or read-write depending on whether your Claw should be able to modify content or only use it as reference material.
You can also set up automatic sync intervals for knowledge base pages. When sync is enabled, ClawStaff will periodically pull updated content from your Notion pages so your Claw always has the latest information. Sync intervals can be set to hourly, daily, or manual-only.
Step 5: Test the Connection
Click the Test Connection button to verify that ClawStaff can read from your Notion workspace. The test will attempt to fetch the title and first block of content from one of your shared pages. If successful, you will see a preview of the retrieved content in the dashboard along with a green confirmation badge.
To test write access, navigate to your Claw’s settings and trigger a test action that creates a new page or appends a block to an existing page. Check your Notion workspace to confirm the content was created correctly. If the test fails, return to Notion’s integration settings page and verify that the correct pages are shared with the ClawStaff integration.