---
title: "Notion MCP server for AI agents - actionlake"
description: "Give Claude 69 Notion actions through one MCP server: agents, pages, data sources, views. Your agent never holds the credential. 100,000 calls a month free."
canonical: https://actionlake.com/connectors/notion
updated: 2026-09-21
---

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 free](https://actionlake.com/console?start=sandbox) [See pricing](https://actionlake.com/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
```

- 69 actions in one signed file
- 33 read look, never change
- 27 write create and update
- 9 wait for a yes destructive, 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.
   - `token` Notion 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 call
   check { 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-11`api.notion.com`

**Built from**

Notion's documentation, read 17 September 2026[developers.notion.com](https://developers.notion.com/reference/intro)

**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.

- **33** read look, never change
- **27** write create and update
- **9** destructive wait 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](https://developers.notion.com/guides/mcp/get-started-with-mcp), 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.

| Action | What it does | Effect | Same name in |
| --- | --- | --- | --- |
| `notion.file_uploads.list` List file uploads | List this integration's file uploads, newest first. | read | `content.file.list` 77 connectors |
| `notion.users.list` List all users | List the workspace's members and bots (guests excluded). | read | `identity.user.list` 474 connectors |
| `notion.comments.list` List comments | List the unresolved comments on a page or block. | read | `content.document_comment.list` 10 connectors |
| `notion.file_uploads.get` Retrieve a file upload | Retrieve a file upload's status and metadata. | read | `content.file.get` 74 connectors |
| `notion.users.get` Retrieve a user | Retrieve one user (person or bot) by id. | read | `identity.user.get` 399 connectors |
| `notion.comments.create` Create comment | Comment on a page or block, or reply in an existing discussion thread. | write | `content.document_comment.create` 6 connectors |
| `notion.data_sources.list_templates` List data source templates | List the page templates available for a data source. | read | `content.content_template.list` 22 connectors |
| `notion.data_sources.create` Create a data source | Add a data source (table of properties) to an existing database. | write | `content.table.create` 16 connectors |
| `notion.databases.create` Create a database | Create a database (and its initial data source) under a page or the workspace. | write | `content.database.create` 15 connectors |
| `notion.comments.delete` Delete comment | Delete a comment by id. | destructive | `content.document_comment.delete` 4 connectors |
| `notion.pages.create` Create a page | Create a page under a data source (database row), a page or a database. | write | `content.site_page.create` 9 connectors |
| `notion.users.me` Retrieve the token's bot user | Who am I: the user record behind the token. | read | `identity.current_user.get` 307 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. Read read
   Which Notion files changed this week, and who changed them?
   calls `notion.file_uploads.list`
2. Plan write
   Upload a file and attach it to a Notion page in Notion.
   calls `notion.pages.get` `notion.file_uploads.create` `notion.file_uploads.get` `notion.file_uploads.complete` `notion.blocks.append_children` +1 more
3. Plan write
   Capture a meeting note and file it under a parent page in Notion.
   calls `notion.users.me` `notion.blocks.create_meeting_note` `notion.blocks.list_children` `notion.blocks.append_children` `notion.comments.create`
4. Write write
   Create comment in Notion. Show me exactly what you will send before you save it.
   calls `notion.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 decides Trash _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 decides Permanently 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 comment `notion.comments.delete`
- Trash a data source `notion.data_sources.trash`
- Trash a page `notion.pages.trash`
- Trash a database `notion.databases.trash`
- Delete a view `notion.views.delete`
- Delete a block `notion.blocks.delete`
- Cancel a session `notion.sessions.cancel`
- Delete an agent `notion.agents.delete`
- Delete a view query `notion.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.

do notion.comments.delete confirm_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: "lead@example.com" },
    { match: "notion.data_sources.trash", approver: "lead@example.com" },
    { match: "notion.pages.trash", approver: "lead@example.com" }
  ]
}
```

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.

- 1 upstream call per action all 69 Notion actions
- 69 actions page each page of a long list is one call
- 33 reads can be cached a cache hit costs nothing
- 100,000 calls a month, free paid plans from US$49 a month for 250,000

[See pricing](https://actionlake.com/pricing)

Action index

## Every Notion action.

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

**Agents 12**

- `notion.agents.batch` Batch manage agents write
- `notion.agents.delete` Delete an agent destructive
- `notion.agents.get` Retrieve an agent read
- `notion.agents.get_insights` Retrieve agent insights read
- `notion.agents.query` Query agents read
- `notion.agents.update_credit_limit` Update an agent credit limit write
- `notion.agents.update_status` Update agent status write
- `notion.sessions.cancel` Cancel a session destructive
- `notion.sessions.create` Create or update a session write
- `notion.sessions.get` Retrieve a session read
- `notion.sessions.query` Query sessions read
- `notion.sessions.query_events` Query session events read

**Pages 11**

- `notion.pages.archive` Archive a page write
- `notion.pages.create` Create a page write
- `notion.pages.get` Retrieve a page read
- `notion.pages.get_markdown` Retrieve a page as markdown read
- `notion.pages.get_property` Retrieve a page property item read
- `notion.pages.move` Move a page write
- `notion.pages.restore` Restore a page from the trash write
- `notion.pages.trash` Trash a page destructive
- `notion.pages.unarchive` Un-archive a page write
- `notion.pages.update` Update page write
- `notion.pages.update_markdown` Update a page's content as markdown write

**Data sources 8**

- `notion.data_sources.create` Create a data source write
- `notion.data_sources.get` Retrieve a data source read
- `notion.data_sources.list_templates` List data source templates read
- `notion.data_sources.query` Query a data source read
- `notion.data_sources.restore` Restore a data source write
- `notion.data_sources.trash` Trash a data source destructive
- `notion.data_sources.update` Update a data source write
- `notion.data_sources.update_properties` Update data source properties write

**Views 8**

- `notion.views.create` Create a view write
- `notion.views.create_query` Create a view query read
- `notion.views.delete` Delete a view destructive
- `notion.views.delete_query` Delete a view query destructive
- `notion.views.get` Retrieve a view read
- `notion.views.get_query_results` Get view query results read
- `notion.views.list` List views read
- `notion.views.update` Update a view write

**Blocks 5**

- `notion.blocks.append_children` Append block children write
- `notion.blocks.delete` Delete a block destructive
- `notion.blocks.get` Retrieve a block read
- `notion.blocks.list_children` Retrieve block children read
- `notion.blocks.update` Update a block write

**Comments 5**

- `notion.comments.create` Create comment write
- `notion.comments.delete` Delete comment destructive
- `notion.comments.get` Retrieve a comment read
- `notion.comments.list` List comments read
- `notion.comments.update` Update comment write

**Databases 5**

- `notion.databases.create` Create a database write
- `notion.databases.get` Retrieve a database read
- `notion.databases.restore` Restore a database write
- `notion.databases.trash` Trash a database destructive
- `notion.databases.update` Update a database write

**Files 4**

- `notion.file_uploads.complete` Complete a file upload write
- `notion.file_uploads.create` Create a file upload write
- `notion.file_uploads.get` Retrieve a file upload read
- `notion.file_uploads.list` List file uploads read

**Skills 3**

- `notion.plugins.get` Get plugin read
- `notion.plugins.list` List plugins read
- `notion.skills.get` Get skill read

**Users 3**

- `notion.users.get` Retrieve a user read
- `notion.users.list` List all users read
- `notion.users.me` Retrieve the token's bot user read

**Meeting notes 2**

- `notion.blocks.create_meeting_note` Create a meeting note write
- `notion.blocks.query_meeting_notes` Query meeting notes read

**Workspace 2**

- `notion.async_tasks.get` Retrieve an async task read
- `notion.custom_emojis.list` List custom emojis read

**Search 1**

- `notion.search.query` Search by title read

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

- [Confluence 22](https://actionlake.com/connectors/confluence)
- [Microsoft SharePoint 17](https://actionlake.com/connectors/microsoft-sharepoint)
- [Box 12](https://actionlake.com/connectors/box)
- [Keboola 7](https://actionlake.com/connectors/keboola)
- [Zoho WorkDrive 6](https://actionlake.com/connectors/zoho-workdrive)
- [Microsoft OneDrive 5](https://actionlake.com/connectors/microsoft-onedrive)

Joins with, on shared entities

- [Slack 2](https://actionlake.com/connectors/slack)
- [Canvas LMS 2](https://actionlake.com/connectors/canvas-lms)
- [Appwrite Cloud 2](https://actionlake.com/connectors/appwrite-cloud)
- [Teamwork 2](https://actionlake.com/connectors/teamwork)
- [ERPNext (Frappe) 2](https://actionlake.com/connectors/erpnext-frappe)
- [Lark Suite 2](https://actionlake.com/connectors/lark-suite)

Browse

- [All Files & documents connectors](https://actionlake.com/connectors/category/files-and-documents)
- [All connectors](https://actionlake.com/connectors)
- [How actionlake compares](https://actionlake.com/compare)

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 free](https://actionlake.com/console?start=sandbox) [See pricing](https://actionlake.com/pricing)

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

---

Source: https://actionlake.com/connectors/notion
More: https://actionlake.com/llms.txt