Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.anyshift.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Notion Integration

Connect Notion to give Annie visibility into your team’s documentation, runbooks, and knowledge base. During an incident or chat session, Annie can search Notion for relevant procedures, retrieve page bodies, and (when permitted) update pages or post comments.

​
Setup Guide

​
1. Create a Notion internal integration

  1. Go to Notion’s My Integrations page and click + New integration.
  2. Give it a name (e.g. Anyshift / Annie) and associate it with the workspace you want Annie to access.
  3. On the Capabilities tab, grant the capabilities you want Annie to use — at minimum Read content. Add Update content, Insert content, and Read user information if you want Annie to make changes or resolve user mentions.
  4. Submit and copy the Internal Integration Token (starts with ntn_...).

​
2. Share the relevant pages and databases with the integration

Notion integrations are opt-in per page: Annie can only see pages that have been explicitly shared with your integration. For each top-level page or database you want Annie to access:
  1. Open the page in Notion.
  2. Click … → Connect to → select your Anyshift / Annie integration.
  3. The integration also gains access to child pages and databases automatically.
For broad access, share a single high-level workspace page (e.g. an Engineering or Runbooks parent) and Annie will be able to read everything beneath it.

​
3. Connect Notion to Anyshift

  1. Go to the Notion integration page.
  2. Click New token.
  3. Fill in the form fields below and click Save Notion token.

​
Display name

A human-readable label for this token (e.g. Engineering Workspace). Used only to identify the credential in the Anyshift UI.

​
Integration token

Paste the Internal Integration Token you copied in step 1 (starts with ntn_...).

​
Required Permissions

The integration needs these Notion capabilities for Annie to read and edit content:
  • Read content — Required. Lets Annie search and read pages, databases, and blocks.
  • Update content — Optional. Lets Annie edit blocks and update page properties.
  • Insert content — Optional. Lets Annie create new pages, append blocks, or move pages.
  • Read user information — Optional. Lets Annie resolve @mentions and assignees.
  • Read comments / Insert comments — Optional. Lets Annie read and add comments.
Without Update / Insert content, Annie can still search and quote Notion pages — it just can’t make changes.

​
How It Works

Anyshift runs the official open-source @notionhq/notion-mcp-server on its agent gateway and authenticates against your Notion workspace using the integration token you provided. Once connected, Annie’s AI agent can:
  • Search your workspace — Free-text search across all pages and databases the integration has access to (post-search).
  • Read pages and runbooks — Retrieve page bodies, including nested blocks and child pages (retrieve-a-page, get-block-children).
  • Query databases — Filter and sort rows in any database the integration can see (query-data-source, retrieve-a-data-source, retrieve-a-database).
  • Update content — When permitted, edit blocks, update page properties, create pages, append children, move pages, and add comments.
  • Resolve users and mentions — Look up workspace members to interpret @mentions and assignees.

​
Security & scope

  • Annie only sees pages explicitly shared with the integration — there is no workspace-wide access by default.
  • The integration token is encrypted at rest (KMS) and is only decrypted in-process by Anyshift’s gateway when Annie makes a Notion call.
  • You can revoke access at any time by removing the integration from a page (or by deleting the integration entirely in Notion).
Anyshift + Notion = Annie answers from your team’s actual runbooks, not generic best-practices.