Skip to content
actionlake
Start free

Connectors · Files & documents

Notion MCP server for AI agents.

actionlake is an MCP gateway: one remote MCP server that connects Claude and other MCP clients to Notion and the rest of your systems. It gives your agent 69 Notion actions (33 reads, 27 writes and 9 that wait for a confirmation) and holds the Notion credential itself, so the agent never does. It paces Notion's limits and records every call.

Connect Notion freeSee pricing

100,000 free calls a month. No card, no email, no password: press Start a free sandbox on the next screen and keep the key it shows you.

claude mcp add --transport http actionlake https://connect.actionlake.com/mcp
the first call
do {  action: "notion.file_uploads.list",  intent: "check which Notion account is connected"}# List file uploads · read · 1 upstream call
  • 69actionsin one signed file
  • 33readlook, never change
  • 27writecreate and update
  • 9wait for a yesdestructive, confirmed first

Set up

Connect Notion in three steps.

  1. 01

    Add actionlake to Claude.

    Run the command once in Claude Code; its consent page can create a free sandbox: 100,000 calls a month, no card. In the Claude app, add a custom connector with the URL below and paste your key on the consent page. Creating a new sandbox from the Claude app is not yet tested by us.

    https://connect.actionlake.com/mcp
  2. 02

    Connect Notion.

    Bearer token. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead. actionlake stores what you paste write-only, sealed under your tenant's key.

    • tokenNotion integration secret (internal integration token `ntn_...`/`secret_...`, personal access token, or an OAuth…
    account { op: "connections.requirements", service: "notion" }
# free: exactly what to paste, and what is found for you
  3. 03

    Make the first call. Check before a write.

    Ask in plain words; Claude picks the action. Before anything changes, check validates the call and prices it, for free.

    do    { action: "notion.file_uploads.list" }# list file uploads · read · 1 upstream callcheck { action: "notion.comments.create", input: { … } }# free: inputs, permissions, cost and confirmations, nothing sent

Notion at a glance

Sign-in
Bearer token. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead.
You provide
token
Limits we pace to
180 calls a minute, per connection
API covered
Notion API 2026-03-11api.notion.com
Built from
Notion's documentation, read 17 September 2026developers.notion.com
Service file
Version 1.0.0, signed (Ed25519)
Cached reads
33 of 33 reads, for up to an hour; a write clears what it affects
Ready-made plans
6 in the store
Shared entities
3, so ask can line Notion up with your other systems
Data
Processed and stored in Sydney, Australia. No US region yet

Capabilities

What an AI agent can do in Notion.

69 actions in 13 areas. Every one carries its effect, so a key can allow the reads and hold the rest.

  • 33readlook, never change
  • 27writecreate and update
  • 9destructivewait for a confirmation

  1. Agents

    12

    6 read · 4 write · 2 destructive

    Retrieve a session · Create or update a session · Batch manage agents · Update an agent credit limit

  2. Pages

    11

    3 read · 7 write · 1 destructive

    Create a page · Retrieve a page · Retrieve a page as markdown · Retrieve a page property item

  3. Data sources

    8

    3 read · 4 write · 1 destructive

    List data source templates · Create a data source · Query a data source · Retrieve a data source

  4. Views

    8

    4 read · 2 write · 2 destructive

    List views · Create a view · Retrieve a view · Update a view

  5. Blocks

    5

    2 read · 2 write · 1 destructive

    Append block children · Retrieve block children · Update a block · Retrieve a block

  6. Comments

    5

    2 read · 2 write · 1 destructive

    List comments · Create comment · Retrieve a comment · Update comment

  7. Databases

    5

    1 read · 3 write · 1 destructive

    Create a database · Retrieve a database · Restore a database · Update a database

  8. Files

    4

    2 read · 2 write · 0 destructive

    List file uploads · Retrieve a file upload · Complete a file upload · Create a file upload

5 more areas · 11 actions
  • Skills 3
  • Users 3
  • Meeting notes 2
  • Workspace 2
  • Search 1

Notion's own MCP server

Notion's MCP server, or actionlake?

Notion runs a remote MCP server at mcp.notion.com, signed in with OAuth; MCP tokens without a browser sign-in are for Business and Enterprise plans.

Use Notion's server when one person wants to work in Notion from their own AI client. Use actionlake when you also want Notion behind the same endpoint as your other systems: a key per agent with allowed actions and a spending cap, a named person's approval before destructive actions, a sealed record of every call, and one ask across Notion and another system.

Source: Notion's documentation, checked 22 October 2026.

Top actions

The Notion API, shaped for agents.

The ids your agent types, what each does, and the one name it shares with other systems. 53 of Notion's 59 action names are shared with at least one other connector, so an agent learns them once.

ActionWhat it doesEffectSame name in
notion.file_uploads.listList file uploadsList this integration's file uploads, newest first.readcontent.file.list77 connectors
notion.users.listList all usersList the workspace's members and bots (guests excluded).readidentity.user.list474 connectors
notion.comments.listList commentsList the unresolved comments on a page or block.readcontent.document_comment.list10 connectors
notion.file_uploads.getRetrieve a file uploadRetrieve a file upload's status and metadata.readcontent.file.get74 connectors
notion.users.getRetrieve a userRetrieve one user (person or bot) by id.readidentity.user.get399 connectors
notion.comments.createCreate commentComment on a page or block, or reply in an existing discussion thread.writecontent.document_comment.create6 connectors
notion.data_sources.list_templatesList data source templatesList the page templates available for a data source.readcontent.content_template.list22 connectors
notion.data_sources.createCreate a data sourceAdd a data source (table of properties) to an existing database.writecontent.table.create16 connectors
notion.databases.createCreate a databaseCreate a database (and its initial data source) under a page or the workspace.writecontent.database.create15 connectors
notion.comments.deleteDelete commentDelete a comment by id.destructivecontent.document_comment.delete4 connectors
notion.pages.createCreate a pageCreate a page under a data source (database row), a page or a database.writecontent.site_page.create9 connectors
notion.users.meRetrieve the token's bot userWho am I: the user record behind the token.readidentity.current_user.get307 connectors

Try it

Prompts to paste into Claude.

Each one names the Notion actions it will call, so you know what it reads and what it changes before you send it.

  1. Readread

    Which Notion files changed this week, and who changed them?

    callsnotion.file_uploads.list

  2. Planwrite

    Upload a file and attach it to a Notion page in Notion.

    callsnotion.pages.getnotion.file_uploads.createnotion.file_uploads.getnotion.file_uploads.completenotion.blocks.append_children+1 more

  3. Planwrite

    Capture a meeting note and file it under a parent page in Notion.

    callsnotion.users.menotion.blocks.create_meeting_notenotion.blocks.list_childrennotion.blocks.append_childrennotion.comments.create

  4. Writewrite

    Create comment in Notion. Show me exactly what you will send before you save it.

    callsnotion.comments.create

The plan store

Ready-made plans for Notion.

6 plans in the store. Install one and your agent runs it by name; the reply says which connections are still missing. A schedule can run a plan on a timetable. There are no triggers or webhooks, by design.

  1. Build a weekly digest page of recent workspace activity

    Use it when Someone wants a Monday-morning summary page of what changed in the Notion workspace last week.

    Effect
    write
    Steps
    5 · loops
    Needs
    parent and query
    Install
    notion-weekly-workspace-digest

  2. Upload a file and attach it to a Notion page

    Use it when A document or image must be uploaded to Notion and attached to a specific page in one reliable pass.

    Effect
    write
    Steps
    6
    Needs
    content type, external url, filename and page id
    Install
    notion-attach-file-to-page

  3. Capture a meeting note and file it under a parent page

    Use it when A meeting just finished and its notes plus follow-ups should land in Notion in one pass.

    Effect
    write
    Steps
    6
    Needs
    parent, source and title
    Install
    notion-capture-meeting-note-page

  4. Create a filtered view and publish its first results

    Use it when A team needs a saved filtered view on a Notion database and wants its first results announced.

    Effect
    write
    Steps
    6
    Needs
    data source id, database id, name and type
    Install
    notion-publish-tracked-database-view

  5. Archive stale rows from a Notion data source

    Use it when A Notion database has accumulated old rows and someone wants them trashed after a human sign-off.

    A person decidesTrash number of items rows in Notion data source title last edited before cutoff.

    Effect
    destructive
    Steps
    6 · loops
    Needs
    data source id and days
    Install
    notion-archive-stale-database-rows

  6. Retire a Notion agent after reviewing its usage

    Use it when An agent in Notion is no longer wanted and should be paused, reviewed, then deleted with sign-off.

    A person decidesPermanently delete Notion agent name with number of items recent sessions.

    Effect
    destructive
    Steps
    7
    Needs
    agent id
    Install
    notion-retire-notion-agent
install a plan
account { op: "plans.install", slug: "notion-weekly-workspace-digest" }
# then ask for it by name; a schedule can run it on a timetable

Governance for Notion

Destructive actions wait for a yes.

9 Notion actions are destructive. These are all of them:

  • Delete commentnotion.comments.delete
  • Trash a data sourcenotion.data_sources.trash
  • Trash a pagenotion.pages.trash
  • Trash a databasenotion.databases.trash
  • Delete a viewnotion.views.delete
  • Delete a blocknotion.blocks.delete
  • Cancel a sessionnotion.sessions.cancel
  • Delete an agentnotion.agents.delete
  • Delete a view querynotion.views.delete_query

A destructive action runs only with confirm: true. Under the human policy the agent cannot confirm for itself: the run stops until a named person approves, in the console or from a signed link in an email. The cap on a key is refused before the call is sent, never after.

donotion.comments.deleteconfirm_policy: human

Delete comment?

intent: the user asked me to delete comment

run suspended · waiting for a named person · key notion-agent cannot confirm itself
In the console, or from an emailed signed link.
a key for this connector
account {  op: "keys.create", name: "notion-agent",  allowed_actions: ["notion.*"], cap_calls: 2000,  confirm_policy: "human_for_writes",  approval_rules: [    { match: "notion.comments.delete", approver: "[email protected]" },    { match: "notion.data_sources.trash", approver: "[email protected]" },    { match: "notion.pages.trash", approver: "[email protected]" }  ]}
Illustrative. Scoped to Notion only, capped at 2,000 upstream calls, every write confirmed, and the destructive ones approved by a named person.

Cost

What Notion costs on actionlake.

Every Notion action is one upstream call, the only thing actionlake bills. Searching, check, cost, account and any call Notion refused with 401, 403, 429 or a 5xx are free. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.

  • 1upstream call per actionall 69 Notion actions
  • 69actions pageeach page of a long list is one call
  • 33reads can be cacheda cache hit costs nothing
  • 100,000calls a month, freepaid plans from US$49 a month for 250,000

See pricing

Action index

Every Notion action.

69 actions by area: the id your agent calls, what it does, and its effect.

Agents12
  • notion.agents.batchBatch manage agentswrite
  • notion.agents.deleteDelete an agentdestructive
  • notion.agents.getRetrieve an agentread
  • notion.agents.get_insightsRetrieve agent insightsread
  • notion.agents.queryQuery agentsread
  • notion.agents.update_credit_limitUpdate an agent credit limitwrite
  • notion.agents.update_statusUpdate agent statuswrite
  • notion.sessions.cancelCancel a sessiondestructive
  • notion.sessions.createCreate or update a sessionwrite
  • notion.sessions.getRetrieve a sessionread
  • notion.sessions.queryQuery sessionsread
  • notion.sessions.query_eventsQuery session eventsread
Pages11
  • notion.pages.archiveArchive a pagewrite
  • notion.pages.createCreate a pagewrite
  • notion.pages.getRetrieve a pageread
  • notion.pages.get_markdownRetrieve a page as markdownread
  • notion.pages.get_propertyRetrieve a page property itemread
  • notion.pages.moveMove a pagewrite
  • notion.pages.restoreRestore a page from the trashwrite
  • notion.pages.trashTrash a pagedestructive
  • notion.pages.unarchiveUn-archive a pagewrite
  • notion.pages.updateUpdate pagewrite
  • notion.pages.update_markdownUpdate a page's content as markdownwrite
Data sources8
  • notion.data_sources.createCreate a data sourcewrite
  • notion.data_sources.getRetrieve a data sourceread
  • notion.data_sources.list_templatesList data source templatesread
  • notion.data_sources.queryQuery a data sourceread
  • notion.data_sources.restoreRestore a data sourcewrite
  • notion.data_sources.trashTrash a data sourcedestructive
  • notion.data_sources.updateUpdate a data sourcewrite
  • notion.data_sources.update_propertiesUpdate data source propertieswrite
Views8
  • notion.views.createCreate a viewwrite
  • notion.views.create_queryCreate a view queryread
  • notion.views.deleteDelete a viewdestructive
  • notion.views.delete_queryDelete a view querydestructive
  • notion.views.getRetrieve a viewread
  • notion.views.get_query_resultsGet view query resultsread
  • notion.views.listList viewsread
  • notion.views.updateUpdate a viewwrite
Blocks5
  • notion.blocks.append_childrenAppend block childrenwrite
  • notion.blocks.deleteDelete a blockdestructive
  • notion.blocks.getRetrieve a blockread
  • notion.blocks.list_childrenRetrieve block childrenread
  • notion.blocks.updateUpdate a blockwrite
Comments5
  • notion.comments.createCreate commentwrite
  • notion.comments.deleteDelete commentdestructive
  • notion.comments.getRetrieve a commentread
  • notion.comments.listList commentsread
  • notion.comments.updateUpdate commentwrite
Databases5
  • notion.databases.createCreate a databasewrite
  • notion.databases.getRetrieve a databaseread
  • notion.databases.restoreRestore a databasewrite
  • notion.databases.trashTrash a databasedestructive
  • notion.databases.updateUpdate a databasewrite
Files4
  • notion.file_uploads.completeComplete a file uploadwrite
  • notion.file_uploads.createCreate a file uploadwrite
  • notion.file_uploads.getRetrieve a file uploadread
  • notion.file_uploads.listList file uploadsread
Skills3
  • notion.plugins.getGet pluginread
  • notion.plugins.listList pluginsread
  • notion.skills.getGet skillread
Users3
  • notion.users.getRetrieve a userread
  • notion.users.listList all usersread
  • notion.users.meRetrieve the token's bot userread
Meeting notes2
  • notion.blocks.create_meeting_noteCreate a meeting notewrite
  • notion.blocks.query_meeting_notesQuery meeting notesread
Workspace2
  • notion.async_tasks.getRetrieve an async taskread
  • notion.custom_emojis.listList custom emojisread
Search1
  • notion.search.querySearch by titleread

Questions

The Notion MCP server, answered.

Is there a Notion MCP server for Claude?

Yes. actionlake is an MCP gateway: a remote MCP server that gives Claude, or another MCP client, 69 Notion actions across agents, pages, data sources and views, through the same eight tools it uses for every other connector. actionlake is independent; it is not made or endorsed by Notion.

Does Notion have its own MCP server?

Notion runs a remote MCP server at mcp.notion.com, signed in with OAuth; MCP tokens without a browser sign-in are for Business and Enterprise plans. (Notion's documentation, checked 22 October 2026.) Use Notion's server when one person wants to work in Notion from their own AI client. Use actionlake when you also want Notion behind the same endpoint as your other systems: a key per agent with allowed actions and a spending cap, a named person's approval before destructive actions, a sealed record of every call, and one ask across Notion and another system.

What do I need to connect Notion?

Notion integration secret (internal integration token `ntn_...`/`secret_...`, personal access token, or an OAuth…. The free call account { op: "connections.requirements", service: "notion" } lists exactly what to paste.

Can an AI agent delete or change things in Notion?

Only if its key allows it, and only with an explicit confirmation. 9 Notion actions are destructive, including delete comment, trash a data source and trash a page. Each runs only with confirm: true. Under the human confirm policy, or an approval rule on the key, the run waits until a named person approves it.

Will an AI agent use up my Notion API limit?

actionlake paces every call to the limits in the Notion service file: 180 calls a minute per connection. Repeated reads are answered from cache (33 Notion actions can be), which never reaches Notion.

What does a Notion action cost?

One upstream call, the only unit actionlake bills. A list that pages bills one call per page (69 Notion actions page). Cache hits, searches, dry runs and calls Notion refused with 401, 403, 429 or a 5xx are free. The Free plan includes 100,000 calls a month with no card. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.

Which Notion API does it cover?

The Notion API 2026-03-11 at api.notion.com. It is built from Notion's documentation as read on 17 September 2026. 69 actions in 13 areas, each one in the signed service file (version 1.0.0).

Does actionlake keep my Notion data, and where?

actionlake processes and stores data in Sydney, Australia; there is no US region yet. Reads may be cached for up to an hour, and a write clears the reads it affects. Each run's request and response is kept, sealed, for your plan's trace window: 1 day on Free, 3 days on Starter, 7 days on Pro, 14 days on Team, 30 days on Business and 30 days on Enterprise. Your Notion credential is sealed under your tenant's key, never logged and never returned. Your traffic is not used to train models.

Which AI clients can use it?

Claude Code, tested by us end to end, and the Claude app as a custom connector, tested by us with an existing key. Other MCP clients that support remote servers over Streamable HTTP (MCP revisions 2025-06-18 and 2025-11-25) and OAuth dynamic client registration, or a bearer header, should connect the same way; we have not tested them. Or plain REST, under the same action names.

More connectors like Notion

Shares the most action names with

Joins with, on shared entities

Browse

actionlake is independent. It is not made or endorsed by Notion; the name is the vendor's own. Counts are from the Notion service file, version 1.0.0.

Give your agent Notion today.

Connect Notion freeSee pricing

Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free.