Notion Integration with OWL

This project demonstrates the integration of Notion with OWL (Optimized Workforce Learning) using the official Notion MCP server. It provides automated interaction with Notion workspaces through AI agents.

Prerequisites

• Python >=3.10,<3.13
• Node.js and npm
• CAMEL framework installed
• A Notion account and integration

Installation

1. Clone this repository:

git clone https://github.com/camel-ai/owl.git
cd owl

2. Install dependencies:

pip install -r requirements.txt

3. Set up environment variables:

• Create a .env file and add your API keys/configuration as needed.

Setup

1. Install the required Node.js package:

npm install -g @notionhq/notion-mcp-server@latest

2. Set up your Notion integration:

• Go to https://www.notion.so/profile/integrations
• Create a new integration
• Copy the integration token
• Update mcp_servers_config.json with your token

3. Connect your Notion pages:

• Open each Notion page you want to work with
• Click "..." (three dots) in the top right
• Select "Add connections"
• Choose your integration

4. Visit official Notion MCP GitHub Repository

Visit the Notion_MCP GitHub Repo for detailed setup instructions.

Usage

Navigate to the community use case directory before running the script:

cd community_usecase/Notion_MCP

Run the script using:

python notion_manager.py

This will run the default task which:

• Searches for a specific page
• Updates its properties
• Adds a comment

Supported Operations

The integration supports these Notion API operations:

• Searching for pages
• Reading page content
• Updating page properties
• Adding comments
• Creating new pages
• Retrieving database content

Troubleshooting

If you encounter errors:

1. Verify your Notion token is correct
2. Check that pages are connected to your integration
3. Ensure you have the required permissions
4. Check the Notion API version in config matches the current version

Error Handling

The script includes:

• Graceful connection handling
• Task execution error catching
• Proper cleanup on exit
• Windows-specific asyncio handling

Repository

For more details, visit the OWL repository: OWL GitHub Repo