matimo-notion

Notion tools for Matimo — create pages, query databases, search, and manage content.

Installation

pip install matimo matimo-notion

Available Tools (7 Total)

Quick Start

import asyncio
from matimo import Matimo
from matimo_notion import get_tools_path

async def main():
    matimo = await Matimo.init(get_tools_path())

    # Search for pages/databases
    results = await matimo.execute('notion_search', {
        'query': 'Product Roadmap',
    })

    # Query a database
    rows = await matimo.execute('notion_query_database', {
        'database_id': 'your-database-id',
        'filter': {'property': 'Status', 'select': {'equals': 'In Progress'}},
    })

    # Create a page in a database
    await matimo.execute('notion_create_page', {
        'parent_id': 'your-database-id',
        'title': 'New Task',
        'properties': {'Status': {'select': {'name': 'Todo'}}},
    })

asyncio.run(main())

Authentication

export NOTION_API_KEY="secret_your-integration-token"

Setting Up a Notion Integration

1. Go to notion.so/my-integrations → New integration
2. Set capabilities: Read content, Update content, Insert content
3. Copy the Internal Integration Secret
4. Share the pages/databases you want to access with your integration

Documentation

• Notion API Reference
• Python Examples

Links

• PyPI: https://pypi.org/project/matimo-notion/
• GitHub: https://github.com/tallclub/matimo
• Notion API Docs: https://developers.notion.com/