Notion Connector

The Notion connector lets the AI access your Notion workspace — reading pages, querying databases, searching content, and creating new pages. It enables workflows like knowledge base Q&A, content creation, and cross-referencing Notion data with other tools.

Setup

Property Value
Category Productivity
Command npx @modelcontextprotocol/server-notion
Required Env Vars NOTION_INTEGRATION_TOKEN

Creating a Notion Integration

  1. Go to notion.so/my-integrations
  2. Click New Integration
  3. Name the integration (e.g., "Workjet")
  4. Select the workspace to connect
  5. Under Capabilities, enable the permissions you need:
    • Read content
    • Insert content (if you want the AI to create pages)
    • Update content (if you want the AI to edit pages)
  6. Click Submit
  7. Copy the Internal Integration Secret

Important: After creating the integration, you must share specific Notion pages and databases with it. The integration can only access pages that have been explicitly shared. Click the "..." menu on a Notion page > "Add connections" > select your integration.

Available Tools

Tool Description
get_page Retrieve the contents of a specific Notion page
query_database Query a Notion database with filters and sorts
search Search across all shared pages and databases
create_page Create a new page in a specified parent page or database

Example Use Cases

  • Knowledge base Q&A: "What does our onboarding documentation say about setting up dev environments?"
  • Content creation: Create an assistant that drafts new Notion pages from templates
  • Project tracking: Query Notion databases to generate status reports via engines
  • Cross-reference: Combine Notion data with GitHub issues or Slack conversations for comprehensive analysis

Next Steps