Skip to main content

Overview

Enable your agents to manage users and create comments through Notion. Access workspace user information and create comments on pages and discussions, streamlining your collaboration workflows with AI-powered automation.

Prerequisites

Before using the Notion integration, ensure you have:
  • A CrewAI AMP account with an active subscription
  • A Notion account with appropriate workspace permissions
  • Connected your Notion account through the Integrations page

Setting Up Notion Integration

1. Connect Your Notion Account

  1. Navigate to CrewAI AMP Integrations
  2. Find Notion in the Authentication Integrations section
  3. Click Connect and complete the OAuth flow
  4. Grant the necessary permissions for user access and comment creation
  5. Copy your Enterprise Token from Integration Settings

2. Install Required Package

3. Environment Variable Setup

To use integrations with Agent(apps=[]), you must set the CREWAI_PLATFORM_INTEGRATION_TOKEN environment variable with your Enterprise Token.
Or add it to your .env file:

Available Actions

Description: List all users in the workspace.Parameters:
  • page_size (integer, optional): Number of items returned in the response. Minimum: 1, Maximum: 100, Default: 100
  • start_cursor (string, optional): Cursor for pagination. Return results after this cursor.
Description: Retrieve a specific user by ID.Parameters:
  • user_id (string, required): The ID of the user to retrieve.
Description: Create a comment on a page or discussion.Parameters:
  • parent (object, required): The parent page or discussion to comment on.
    or
  • rich_text (array, required): The rich text content of the comment.

Usage Examples

Basic Notion Agent Setup

Filtering Specific Notion Tools

User Information and Team Management

Collaboration and Communication

Automated Team Communication

Troubleshooting

Common Issues

Permission Errors
  • Ensure your Notion account has appropriate permissions to read user information
  • Verify that the OAuth connection includes required scopes for user access and comment creation
  • Check that you have permissions to comment on the target pages or discussions
User Access Issues
  • Ensure you have workspace admin permissions to list all users
  • Verify that user IDs are correct and users exist in the workspace
  • Check that the workspace allows API access to user information
Comment Creation Issues
  • Verify that page IDs or discussion IDs are correct and accessible
  • Ensure that rich text content follows Notion’s API format specifications
  • Check that you have comment permissions on the target pages or discussions
API Rate Limits
  • Be mindful of Notion’s API rate limits when making multiple requests
  • Implement appropriate delays between requests if needed
  • Consider pagination for large user lists
Parent Object Specification
  • Ensure parent object type is correctly specified (page_id or discussion_id)
  • Verify that the parent page or discussion exists and is accessible
  • Check that the parent object ID format is correct

Getting Help

Need Help?

Contact our support team for assistance with Notion integration setup or troubleshooting.