Notion as a Tool

Connect contenox to your Notion workspace via the official Notion MCP server. The model can read, create, and update Notion pages as naturally as answering a chat message — no scripts, no SDKs.

Prerequisites

One-time setup: register the Notion remote MCP server and authenticate:

# Register the official Notion MCP remote server (HTTP transport + OAuth)
contenox mcp add notion --transport http \
  --url https://mcp.notion.com/mcp \
  --auth-type oauth

# Authenticate (opens a browser for OAuth consent)
contenox mcp auth notion

Note: Notion’s MCP server uses OAuth 2.0 with dynamic client registration. contenox mcp auth handles the full flow — discovery, registration, authorization code exchange, and token storage — automatically. Tokens are refreshed transparently on each run.

Official docs: Notion MCP server guide

Recipe 1: List recent pages

Ask for your recent Notion pages on a topic, and the model calls Notion’s search tool and reports back.

Example output:

Your recent Notion pages:

• AI Usage in Software Development — created today
• Sprint Planning Q2 — last edited 2 days ago
• Team OKRs — last edited 1 week ago

Recipe 2: Create a page with scaffolded content

Ask it to create a page and scaffold an article on a topic. The model calls create_page, writes the title, and populates the body with a structured outline covering introduction, key benefits, tooling, challenges, and conclusion — returning the live URL.

Example output:

I have created a Notion page titled “AI Usage in Software Development” with a scaffolded outline. You can access and edit it here: https://www.notion.so/3240ef89…

Recipe 3: Search and summarize

Ask it to search your recent pages for a term and summarize. The model calls search_pages, fetches matching content, and summarizes it inline — no copy-pasting required.

How it works

Any chain or agent whose tool allowlist includes the server is handed its tools automatically:

{
  "tasks": [{
    "handler": "chat_completion",
    "system_instruction": "You are Contenox, a helpful AI assistant. Answer the user's questions clearly and helpfully. If you have tools available, use them when appropriate.",
    "execute_config": {
      "tools": ["*"],
      "pass_clients_tools": false
    }
  }]
}

• tools: ["*"] — exposes all registered MCP servers to the model. Add "!name" entries to exclude specific servers (e.g. ["*", "!filesystem"]).
• The task engine handles the full tool-call loop automatically: model calls a tool → result appended to history → model continues.

Scope and limitations

Notion’s MCP server exposes the 14 tools from its official MCP guide — including search, create_page, update_page, retrieve_block_children, and more. Database queries, page updates, and rich block types are all supported.

Access is scoped to the pages and databases the user shared with the integration during OAuth consent.