Notion

Overview

The Notion integration connects your Notion workspace to Monday Morning, enabling bidirectional sync between Notion databases and your project’s tasks and specs. This is useful for teams that use Notion as a shared knowledge base or project tracker alongside Monday Morning’s AI-native workflow.

Prerequisites

• A Notion account
• An internal integration created in Notion’s developer portal
• The integration must be connected to the pages/databases you want to sync

Setup

Step 1: Create a Notion Integration

1. Go to notion.so/my-integrations
2. Click New integration
3. Give it a name (e.g., “Monday Morning”)
4. Select the workspace you want to connect
5. Under Capabilities, ensure the integration has:
   • Read content
   • Update content
   • Insert content
6. Click Submit and copy the Internal Integration Token (starts with ntn_)

Step 2: Connect the Integration to Your Pages

Notion integrations do not have access to any pages by default. You need to explicitly share pages with your integration:

1. Open the Notion page or database you want to sync
2. Click the … menu in the top-right corner
3. Select Connect to and choose your “Monday Morning” integration
4. Repeat for each page or database you want accessible

Step 3: Configure in Monday Morning

Set the NOTION_API_TOKEN environment variable in your shell profile:

export NOTION_API_TOKEN="ntn_your_integration_token_here"

Alternatively, configure it through the Monday Morning desktop app under Settings > Integrations > Notion and paste your token into the Integration Token field.

Step 4: Verify the Connection

Ask your AI agent to sync with Notion:

Sync my Notion database with this project

The agent will call mm_sync_notion. If configured correctly, you will see data flowing between Notion and your .mm/ directory.

Available Tools

Tool	Description
mm_sync_notion	Sync tasks and specs bidirectionally with Notion databases.

Common Workflows

Sync project tasks to a Notion database

Push my Monday Morning tasks to the Notion project tracker

The agent calls mm_sync_notion to export your current tasks and specs into the connected Notion database.

Pull updates from Notion

Pull the latest updates from Notion into this project

The agent calls mm_sync_notion to import changes made in Notion back into your .mm/ data.

Keep a shared knowledge base in sync

For teams where some members use Notion and others use Monday Morning directly, periodic syncs keep both systems aligned.

Troubleshooting

“Unauthorized” error Your integration token is invalid or expired. Generate a new one at notion.so/my-integrations.

Pages not found during sync The integration only has access to pages you have explicitly shared with it. Open the target page in Notion, click … > Connect to, and select your integration.

“Could not find database” error Ensure the database ID is correct and that the integration has been connected to that specific database. Child pages inherit access, but databases in different sections may need separate connections.

Sync conflicts If the same item is modified in both Notion and Monday Morning between syncs, the most recent change wins. Check timestamps if you see unexpected overwrites.