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.
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.
Agent workflows for Notion.
Find a project brief
Use notion.search for title matches, then notion.get_page_content to read the page’s blocks.
Review a tracking table
Use notion.retrieve_data_source to learn the schema and notion.query_data_source to find matching rows.
Record a decision
Use notion.create_page for a new note or notion.append_blocks to add a reviewed decision to an existing page.
Update a row carefully
Use notion.get_page_property to finish reading partial values before notion.update_page_properties replaces them.
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
6Look things up, subject to your permissions.
- notion.searchSearch 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_pageRetrieve 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_contentRead 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_propertyRead 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_sourceRetrieve 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_sourceQuery 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
3Create and change things. Allow, or ask the user first.
- notion.create_pageCreate 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_blocksAdd 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_propertiesUpdate 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
1Delete, cancel or archive. Ask first, or deny outright.
- notion.trash_pageMove 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.
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 approvalsExample policy choices
- Read actions: allow where authorized
- notion.create_page: require approval
- notion.trash_page: deny
Arc0 MCP endpoint: https://api.arc0.ai/mcp
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
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
- 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.
- For Claude Code, run the command below. Open /mcp, select Arc0, and authenticate in your browser. Select your workspace and review access.
- Check the connection with claude mcp get arc0.
claude mcp add --transport http --scope user arc0 https://api.arc0.ai/mcpFull MCP setup and troubleshootingNotion with ChatGPT
ChatGPT on the web
- Open Plugins in ChatGPT, select the plus button, then Add custom MCP server.
- Name it Arc0, enter the server URL below, and choose OAuth. Use dynamic client registration if asked; no Arc0 API key is needed.
- 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/mcpFull MCP setup and troubleshootingNotion with OpenAI Codex
Codex app + CLI
- Run the registration command below. The app and CLI share ~/.codex/config.toml.
- Complete browser OAuth, choose your Arc0 workspace, and review access. If authentication does not start, run codex mcp login arc0.
- 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/mcpFull MCP setup and troubleshootingNotion with Cursor
Remote MCP setup
- Add Arc0 in your client’s remote MCP settings using the server URL below.
- Choose OAuth, sign in to Arc0, select the intended workspace and review access.
- 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/mcpFull MCP setup and troubleshootingNotion with VS Code
Remote MCP setup
- Add a remote HTTP MCP server named Arc0 using the URL below.
- Use OAuth and finish Arc0 sign-in, workspace selection and consent.
- Confirm discovery succeeds before requesting a read. These are generic remote-MCP steps; client UI and availability may differ.
https://api.arc0.ai/mcpFull MCP setup and troubleshootingNotion with Any MCP client
Streamable HTTP
- Use a client that supports remote MCP over Streamable HTTP. Add the server URL below and choose OAuth.
- 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.
- Use the MCP clients guide for the SDK transport example and Embedded identity for business-managed end users.
https://api.arc0.ai/mcpFull MCP setup and troubleshootingAfter 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.
More productivity apps.
Notion and Arc0, answered.
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.
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.
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.
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.
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.
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.
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.