Notion MCP Server Mfy

🚀 Notion自動化操作項目

本項目藉助Python腳本與強大的在線協作工具Notion進行交互，通過集成Notion API實現自動化工作流。能實現內容創建、數據查詢、屬性管理和工作流自動化等功能，可有效提高工作效率。

🚀 快速開始

Notion是一款強大的在線協作工具，支持筆記、任務管理、知識庫構建等多種操作。通過集成Notion API，我們能夠實現自動化工作流，提升效率。下面將詳細介紹如何使用Python腳本與Notion進行交互，涵蓋安裝配置、核心功能及其實現。

✨ 主要特性

1. 內容創建：自動生成和更新頁面、塊內容。
2. 數據查詢：檢索特定數據庫中的記錄。
3. 屬性管理：操作數據庫字段及其值。
4. 工作流自動化：監聽並響應各類事件（如新頁面創建）。

📦 安裝指南

安裝依賴

首先，安裝必要的Python庫：

pip install notional python-dotenv

配置環境變量

創建一個 .env 文件用於存儲Notion API令牌：

NOTION_TOKEN=your_token_here
NOTION_SPACE_ID=your_space_id_here

💻 使用示例

基礎用法

內容創建

通過以下代碼可以創建新的頁面內容：

from notional import Notional

# 初始化 Notional 客戶端
client = Notional(token='your_token')

# 創建新頁面
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']
)

數據查詢

以下代碼展示如何檢索數據庫記錄：

# 獲取數據庫內容
database = client.databases.retrieve('your_database_id')

# 查詢所有記錄
results = client.databases.query('your_database_id', {
    'filter': {
        'property': 'Name',
        'contains': True,
        'query': 'Example'
    }
})

# 處理返回結果
for result in results['results']:
    print(result['properties']['Name']['title'][0]['text']['content'])

屬性管理

操作數據庫字段示例：

# 更新頁面屬性
client.pages.update(
    page_id='your_page_id',
    properties={
        'Status': {
            'select': {
                'name': 'Complete'
            }
        }
    }
)

# 刪除指定屬性
client.properties.delete('property_id')

工作流自動化

通過設置Webhook監聽事件：

from notional.webhooks import Webhook

# 創建並訂閱 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()

📚 詳細文檔

注意事項

1. 權限管理：確保API令牌擁有正確的操作權限。
2. 數據安全：避免在代碼中明文存儲敏感信息，建議使用環境變量或加密存儲。
3. 錯誤處理：針對Notion API返回的狀態碼和錯誤消息進行適當處理。

通過以上步驟，您可以有效地自動化管理Notion工作區內容，提升工作效率。