Notion MCP Server Mfy

🚀 Notion Python Integration

Notion is a powerful online collaboration tool that supports various operations such as note - taking, task management, and knowledge base building. By integrating the Notion API, we can implement automated workflows and improve efficiency. This article details how to use Python scripts to interact with Notion, including installation, configuration, core functions, and their implementation.

🚀 Quick Start

This guide will walk you through the process of using Python to interact with Notion API, enabling you to automate various tasks in your Notion workspace.

✨ Features

1. Content Creation: Automatically generate and update page and block content.
2. Data Query: Retrieve records from specific databases.
3. Attribute Management: Manipulate database fields and their values.
4. Workflow Automation: Listen for and respond to various events (e.g., new page creation).

📦 Installation

Install Dependencies

First, install the necessary Python libraries:

pip install notional python-dotenv

Configure Environment Variables

Create a .env file to store your Notion API token:

NOTION_TOKEN=your_token_here
NOTION_SPACE_ID=your_space_id_here

💻 Usage Examples

Basic Usage

Content Creation

The following code demonstrates how to create new page content:

from notional import Notional

# Initialize the Notional client
client = Notional(token='your_token')

# Create a new page
new_page = {
    'parent': {'database_id': 'your_database_id'},
    'properties': {
        'Name': {
            'title': [
                {
                    'text': {
                        'content': 'New Page'
                    }
                }
            ]
        }
    },
    'children': [
        {
            'object': 'block',
            'type': 'paragraph',
            'paragraph': {
                'rich_text': [
                    {
                        'type': 'text',
                        'text': {'content': 'This is a new page created via Notion API'}
                    }
                ]
            }
        }
    ]
}

response = client.pages.create(
    parent={'database_id': 'your_database_id'},
    properties=new_page['properties'],
    children=new_page['children']
)

Data Query

The following code shows how to retrieve database records:

# Get database content
database = client.databases.retrieve('your_database_id')

# Query all records
results = client.databases.query('your_database_id', {
    'filter': {
        'property': 'Name',
        'contains': True,
        'query': 'Example'
    }
})

# Process the returned results
for result in results['results']:
    print(result['properties']['Name']['title'][0]['text']['content'])

Attribute Management

Example of manipulating database fields:

# Update page attributes
client.pages.update(
    page_id='your_page_id',
    properties={
        'Status': {
            'select': {
                'name': 'Complete'
            }
        }
    }
)

# Delete a specified attribute
client.properties.delete('property_id')

Advanced Usage

Workflow Automation

Set up a Webhook to listen for events:

from notional.webhooks import Webhook

# Create and subscribe to a webhook
webhook = Webhook(client, secret='your_secret_key', url='https://your_endpoint.com/webhook')

@webhook.listener('page_created')
def handle_page_create(event):
    print(f"New page created: {event['page']['id']}")

webhook.start()

📚 Documentation

Important Notes

⚠️ Important Note

• Permission Management: Ensure that the API token has the correct operation permissions.
• Data Security: Avoid storing sensitive information in plain text in the code. It is recommended to use environment variables or encrypted storage.
• Error Handling: Appropriately handle the status codes and error messages returned by the Notion API.

By following the steps above, you can effectively automate the management of your Notion workspace content and improve work efficiency.