Connect Notion to AI agents

Connect Notion to Claude, Codex, Cursor, or other AI agents for your entire team. Metorial security, governance, observability, and gives your team a unified Magic MCP url to connect.

Supported Tools

delete_block

Delete Block

Delete a block from a Notion page. This sets the block to archived and moves it to trash. Can also be used to delete page blocks (effectively trashing a page).

search

Search

Search across all pages and databases shared with the integration by title. Returns matching pages and databases with their metadata. Best suited for finding resources by name rather than exhaustive enumeration.

create_database

Create Database

Create a new database in Notion as a child of an existing page. Define the database schema by specifying property names and types. Supported property types include title, rich_text, number, select, multi_select, date, people, files, checkbox, url, email, phone_number, formula, relation, rollup, status, and more.

get_block_children

Get Block Children

Retrieve the child blocks of a given block or page. Returns the first level of children only. Use a page ID to get the top-level content of a page, or a block ID to get nested content within a specific block. Results are paginated; use the cursor to retrieve additional blocks.

query_database

Query Database

Query a Notion database to retrieve its entries (pages) with optional filtering and sorting. Supports complex filter conditions using compound "and"/"or" filters as well as property-specific filters (text, number, date, checkbox, select, etc.). Results are paginated; use the cursor to fetch subsequent pages.

append_blocks

Append Blocks

Append new content blocks to a page or an existing block. Supports all Notion block types including paragraphs, headings, lists, to-dos, code blocks, callouts, images, embeds, and more. Blocks can be nested up to 2 levels deep in a single request.

create_page

Create Page

Create a new page in Notion as a child of an existing page or as an entry in a database. Provide a parent (either a page ID or database ID) and properties. For database parents, properties must match the database schema. Optionally include initial content as block children, and set an icon or cover image.

update_database

Update Database

Update a Notion database's title, description, schema (properties), icon, or cover. Use this to add, rename, or remove properties from a database schema, or to change database metadata.

list_comments

List Comments

Retrieve unresolved comments on a Notion page or block. Returns comment text, author, timestamps, and discussion thread IDs. Only unresolved comments are returned.

update_page

Update Page

Update an existing Notion page's properties, icon, cover, lock status, or archive status. Use this for modifying page metadata and property values. To modify page content (blocks), use the block management tools instead.

add_comment

Add Comment

Add a comment to a Notion page or reply to an existing discussion thread. Comments can be placed at the top of a page or as a reply to an existing discussion.

update_block

Update Block

Update an existing block's content or archive/delete it. The update fields depend on the block type. Can also be used to archive (soft-delete) a block by setting archived to true.

get_page

Get Page

Retrieve a Notion page by its ID, including all properties, metadata, and optionally its content blocks. Use this to read a page's title, properties, timestamps, parent info, icon, cover, and block content.

get_database

Get Database

Retrieve a Notion database by its ID, including its schema (properties), title, description, and metadata. Use this to inspect a database's structure before querying or creating entries.

list_users

List Users

List all users in the Notion workspace, including admins, members, guests, and bot integrations. Returns user profiles with name, avatar, type, and optionally email addresses (requires user information capability).

More integrations teams use with Notion

Linear

Create, read, update, and delete issues across teams with support for priorities, labels, assignees, due dates, and workflow states. Manage projects that group related issues, and organize work into time-boxed cycles (sprints). Create and manage documents, comments, and file attachments. Search issues using vector similarity or rich filters. Configure teams, workflow states, and labels. Track customers and link them to issues. Subscribe to real-time webhooks for changes to issues, projects, cycles, comments, documents, and more.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Subscribe to webhooks for list and library change notifications. Retrieve site properties and search for sites across Microsoft 365.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Airtable

Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.

Confluence

Create, read, update, and delete pages, blog posts, comments, and attachments in Confluence spaces. Manage spaces, permissions, labels, and content restrictions. Search content using Confluence Query Language (CQL). Upload and download file attachments with versioning. Manage users, groups, and group memberships. Create and manage whiteboards, databases, folders, and templates. View and update inline tasks. Access audit logs. Listen for webhooks on page, blog, comment, attachment, space, label, and user events.

Technical notes for Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles. Receive real-time webhook notifications for page changes, new pages, comments, and database schema updates.

Connect Notion to production AI agents

See how Metorial gives Notion access the governance, tracing, and security controls teams need.

Frequently asked questions

Common questions about connecting Notion to AI agents with Metorial.

  1. Can Metorial connect Notion to AI agents?
    Yes. Metorial connects AI agents to Notion through a governed integration layer, so teams can use the provider while keeping access controlled and observable.
  2. Metorial is MCP compatible and lets teams expose approved provider tools to MCP-capable agents and clients through a controlled access layer.
  3. Metorial applies policies across users, groups, providers, agents, and individual tools, then records the context around every agent interaction.
  4. Yes. Metorial records provider activity so teams can inspect tool calls, troubleshoot integrations, and give security teams the visibility they need.