← All examples

Notion Tool

MCP tool that queries databases, creates pages, and manages Notion workspaces using OAuth. Connect Notion and organize from any agent.

toolnotionoauthdatabasesmcp
Deploy this example

An MCP tool that connects to Notion via OAuth. Query databases, create pages, and manage your workspace — all callable by any agent or MCP client.

What's included

  • OAuth connection — connects to Notion via Reminix managed OAuth
  • Query databases — search and filter database entries
  • Create pages — add new pages and blocks
  • Update properties — modify page metadata and properties
  • MCP server — discoverable and callable by any agent or MCP client

When to use this

Pick the Notion Tool example when you want to:

  • Build an agent that populates or queries Notion databases
  • Create a conversational agent that organizes knowledge in Notion
  • Learn how OAuth connections work with Notion's API

How connections work

Reminix handles the Notion OAuth flow, token exchange, and automatic refresh. Your tool handler receives a valid access token and uses the Notion API directly.

  1. Create a Notion integration and add OAuth credentials in the Reminix dashboard
  2. Authorize the connection to your Notion workspace
  3. Your tool gets fresh tokens on every call

Project structure

├── tools/
│   ├── query_database.py      # Query a Notion database
│   └── create_page.py         # Create a new page
├── main.py                    # Entry point with serve()
├── pyproject.toml
└── reminix.config.toml

Quick start

After deploying and connecting your Notion workspace, any agent in your project can query databases and create pages automatically.