Available

Notion MCP server

Read shared pages and maintain structured Notion records through Arc0’s tools. Access comes from an internal connection token and the pages shared with that connection. Connect through Arc0 to use the actions your identity is allowed to call.

ProductivityAPI keyMCP + RESTnotion.so
AUDIT LOG · NOTIONPOLICY: acme-support
09:41:07 · claude · u_8f2read
notion.search
Search pages and databases✓ allowed · 212ms
09:41:08 · claude · u_8f2read
notion.retrieve_page
Retrieve a page✓ allowed · 164ms
09:41:09 · claude · u_8f2write
notion.create_page
Create a page✓ approved · approved by user
09:41:12 · claude · u_8f2destructive
notion.trash_page
Move a page to trash✕ blocked · policy: deny
ILLUSTRATIVE POLICY TRACE · NOT A LIVE RECEIPT

Working with Notion

A project review often needs both a written brief and the rows that track its delivery. notion.search finds pages and data sources by title among the content shared with the connection. Use notion.get_page_content for the brief itself. It reads one level of blocks at a time, so follow child blocks and pagination before describing a page as fully reviewed.

For a tracking table, call notion.retrieve_data_source before notion.query_data_source. The schema identifies field names and valid select or status options. The agent can then compare matching rows, identify missing dates, or prepare a proposed status change using the actual values in the table.

Write a new note with notion.create_page, or add a decision to an existing page with notion.append_blocks. When using notion.update_page_properties, list and text values replace what is there. A partial property must be read through notion.get_page_property before reuse. notion.trash_page moves a page and its children to Notion’s trash; it is not permanent deletion.

Official MCP reference: Notion documentation.

01 · USE CASES

Agent workflows for Notion.

01

Find a project brief

Use notion.search for title matches, then notion.get_page_content to read the page’s blocks.

02

Review a tracking table

Use notion.retrieve_data_source to learn the schema and notion.query_data_source to find matching rows.

03

Record a decision

Use notion.create_page for a new note or notion.append_blocks to add a reviewed decision to an existing page.

04

Update a row carefully

Use notion.get_page_property to finish reading partial values before notion.update_page_properties replaces them.

02 · ACTIONS

10 Notion actions, graded by risk.

These actions come from the Arc0 registry. Your identity, provider permissions and Arc0 policies determine which actions can run.

read

6

Look things up, subject to your permissions.

  • notion.search
    Search pages and databases

    Search Notion pages and data sources (database tables) shared with the connection by title. Use when the user names a page or database and you need its id. Returns titles, ids and URLs; results are title matches, not full-text. Pass nextCursor as cursor for more.

  • notion.retrieve_page
    Retrieve a page

    Get a Notion page's title, URL, parent, trash state and property values as id, type, value and complete. Use when you have a page id and need its properties, e.g. a row's status or dates. complete false marks a partial value (see get_page_property). Not for the page body.

  • notion.get_page_content
    Read page content

    Read the content blocks of a Notion page (or a block's children) as plain text with block types, table row cells and equations. Use when the user asks what a page says. Returns one level; read hasChildren blocks by id. truncated marks cut text. Pass nextCursor as cursor for more.

  • notion.get_page_property
    Read a full page property

    Read every item of one page property past the 25-item page response limit: relation page ids, people user ids, text segments or rollup values, paginated. Use when a retrieve_page or query value has complete false. Pass nextCursor as cursor until hasMore is false; complete false: no usable value.

  • notion.retrieve_data_source
    Retrieve a database schema

    Get a Notion data source's (database table's) title and property schema: names, types and select/status options. Use when you need valid property names and option values before querying the table or creating or updating its rows.

  • notion.query_data_source
    Query a database

    List rows of a Notion data source (database table), optionally filtered, sorted or limited to some properties; complete false marks a partial value. Use when the user asks which entries match a condition. Get property names from retrieve_data_source first. Pass nextCursor as cursor for more.

write

3

Create and change things. Allow, or ask the user first.

  • notion.create_page
    Create a page

    Create a Notion page under a parent page, or a new row in a data source (database table) with property values, optionally with content blocks. Use when the user asks to add a note, doc or database entry. Not idempotent: on an unknown outcome search before retrying.

  • notion.append_blocks
    Add content to a page

    Append up to 100 text, heading, list, to-do, quote, callout, code, divider or bookmark blocks to a Notion page or block, at the end, the start or after a given block. Use when the user asks to add content to an existing page. Not idempotent: re-read the page before retrying.

  • notion.update_page_properties
    Update page properties

    Change a Notion page's title or a row's property values (status, select, dates, checkboxes, numbers, text, people, relations). Use when the user asks to update a row's fields. A list or text value replaces the whole value: never send one read with complete false; read it via get_page_property.

destructive

1

Delete, cancel or archive. Ask first, or deny outright.

  • notion.trash_page
    Move a page to trash

    Move a Notion page (or database row) and its sub-pages to the trash. Use when the user asks to delete or remove a page. The API has no permanent delete; a workspace member can restore it from the trash in Notion.

03 · POLICIES AND AUDIT

Control access to Notion.

Connect the intended Notion account, authorize your AI client and set policies for its tools.

Provider permissions and Arc0 policy both apply. Allow reads, require approval for selected writes, or deny destructive actions. The audit log records execution decisions.

Configure policies and approvals

Example policy choices

  • Read actions: allow where authorized
  • notion.create_page: require approval
  • notion.trash_page: deny

Arc0 MCP endpoint: https://api.arc0.ai/mcp

04 · AUTH AND DATA

How Notion connects.

Connect Notion using API key. OAuth grants the provider scopes shown during consent; API keys and other credentials retain the permissions configured at the provider. Arc0 stores credentials in its encrypted vault and does not pass them to the model. Disconnect to remove access through Arc0; revoke a key at the provider to invalidate it there. Token refresh and provider-side revocation depend on the authentication lane and provider.

The connection serves authorized calls through Arc0 MCP and REST. How Arc0 handles credentials →

AUTH
API key
CREDENTIALS
Per-tenant encrypted vault
MODEL SEES
Results only, never credentials
AUDIT LOG
Every call, on every plan
05 · AI CLIENTS

Use Notion with your AI client.

Sign in to Arc0 and connect Notion in My apps. Then authorize your AI client separately. It only receives tools and accounts allowed for that identity.

Notion with Claude

Claude Desktop + Claude Code

  1. In Claude Desktop, add Arc0 through the remote MCP settings and use OAuth. Follow the generic remote-client steps if your account’s interface differs.
  2. For Claude Code, run the command below. Open /mcp, select Arc0, and authenticate in your browser. Select your workspace and review access.
  3. Check the connection with claude mcp get arc0.
claude mcp add --transport http --scope user arc0 https://api.arc0.ai/mcp
Full MCP setup and troubleshooting
All apps for Claude
Notion with ChatGPT

ChatGPT on the web

  1. Open Plugins in ChatGPT, select the plus button, then Add custom MCP server.
  2. Name it Arc0, enter the server URL below, and choose OAuth. Use dynamic client registration if asked; no Arc0 API key is needed.
  3. Review the notice and select Create as a plugin. Complete Arc0 sign-in, workspace selection and consent, then install and select the plugin in your conversation. Labels and access vary by account; managed workspaces may require administrator approval.
https://api.arc0.ai/mcp
Full MCP setup and troubleshooting
All apps for ChatGPT
Notion with OpenAI Codex

Codex app + CLI

  1. Run the registration command below. The app and CLI share ~/.codex/config.toml.
  2. Complete browser OAuth, choose your Arc0 workspace, and review access. If authentication does not start, run codex mcp login arc0.
  3. Check codex mcp list, then open a new Codex chat. Inspect an existing arc0 entry before changing it.
codex mcp add arc0 --url https://api.arc0.ai/mcp
Full MCP setup and troubleshooting
All apps for OpenAI Codex
Notion with Cursor

Remote MCP setup

  1. Add Arc0 in your client’s remote MCP settings using the server URL below.
  2. Choose OAuth, sign in to Arc0, select the intended workspace and review access.
  3. Confirm the server is connected and start with an allowed read. These are generic remote-MCP steps; consult your client’s settings for its current interface.
https://api.arc0.ai/mcp
Full MCP setup and troubleshooting
All apps for Cursor
Notion with VS Code

Remote MCP setup

  1. Add a remote HTTP MCP server named Arc0 using the URL below.
  2. Use OAuth and finish Arc0 sign-in, workspace selection and consent.
  3. Confirm discovery succeeds before requesting a read. These are generic remote-MCP steps; client UI and availability may differ.
https://api.arc0.ai/mcp
Full MCP setup and troubleshooting
Notion with Any MCP client

Streamable HTTP

  1. Use a client that supports remote MCP over Streamable HTTP. Add the server URL below and choose OAuth.
  2. For a client without OAuth, use a self-bound API key with execute permission in the X-API-Key header. Store it in secret storage or an environment variable, outside source control. Never send both an API key and an OAuth bearer token.
  3. Use the MCP clients guide for the SDK transport example and Embedded identity for business-managed end users.
https://api.arc0.ai/mcp
Full MCP setup and troubleshooting

After setup, ask your agent to find an allowed read action, load its schema, and execute it on the intended account. Check Activity for the receipt. A connected MCP client alone does not confirm a successful provider call.

07 · FAQ

Notion and Arc0, answered.

Q01

Is there an official Notion MCP server, and how does Arc0 differ?

Yes. Notion hosts an OAuth-based MCP server. Arc0’s current Notion tools use the versioned REST API with an internal connection token and explicit shared-page access.

Q02

Which permissions does Arc0 need for Notion?

Use an internal connection token, not a personal access token or OAuth login. Read content is needed for reads, Insert content for new pages and blocks, and Update content for property changes or trashing. Share the intended pages or data sources with the connection.

Q03

Does this work with Claude, ChatGPT, Codex and Cursor?

Yes, through Arc0 MCP when your Claude, ChatGPT, Codex, or Cursor client supports remote MCP and your account permits it. Connect the app in Arc0 and configure your client using the Arc0 setup guide. App permissions still apply.

Q04

How are credentials stored, refreshed and revoked?

Credentials are encrypted in Arc0’s vault. Internal connection tokens do not refresh. Arc0 disconnect removes local access; rotate the token in Notion’s developer portal to invalidate it elsewhere, or remove the connection’s access to selected pages.

Q05

What happens with rate limits or errors?

Notion enforces connection and workspace limits. Arc0 reports throttling and any supplied wait time. A missing page can also mean it was not shared. Re-read a page after an uncertain append or creation before repeating it.

Q06

What is the availability of these Notion tools?

These tools are available. Connect the app in Arc0 and authorize your AI client. The action list describes the current implementation.

Get started

Plug Notion into your agent.

Notion MCP server: 10 actions including search pages and databases, retrieve a page, read page content. Connect through Arc0.

Free to build · MCP + REST · Audit log on every plan

Notion and its logo are trademarks of their respective owners. Arc0 is not affiliated with or endorsed by Notion.