Notion through One
Notion is an all-in-one workspace for note-taking, project management, wikis, and collaboration. It helps individuals and teams organize ideas, workflows, and content in a flexible interface.
One exposes Notion through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.
How to run an action
- Find the action in the table below, or call
search_one_platform_actions with platform notion if it is not listed.
- Call
get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
- Call
execute_one_action with parameters copied from that knowledge.
Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.
Before you start
Call list_one_integrations once and confirm Notion is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.
Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.
Before a write
Creates, updates, deletes and sends land on a real Notion account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.
Actions
Pages
| Action |
Method |
Path |
Action id |
| Retrieve a Page |
GET |
/pages/{{pageId}} |
conn_mod_def::GJ5EnwZA3JE::sIXduRG5Qc-J8995P9OwGQ |
| Retrieve a Page as Markdown |
GET |
/pages/{{pageId}}/markdown |
conn_mod_def::GJ5EntqNvy0::-VzfhSExTEGGnlXLUMqFcA |
| Create a Page |
POST |
/pages |
conn_mod_def::GJ5EnlW1AEk::mEAQjNttT1GjVqNeMTvDiw |
| Move a Page |
POST |
/pages/{{pageId}}/move |
conn_mod_def::GJ5EntUR1NM::0CtCVtZ8RIi-l6NROlnlGg |
| Update a Page |
PATCH |
/pages/{{pageId}} |
conn_mod_def::GJ5En6Rb6Bg::HBiyT8YHSkWyd8Wg5qHFCg |
| Update a Page’s Markdown Content |
PATCH |
/pages/{{pageId}}/markdown |
conn_mod_def::GJ5EnyDM2AM::cL9O2-s6RdqatjFJf_Wwcw |
FileUploads
| Action |
Method |
Path |
Action id |
| List File Uploads |
GET |
/file_uploads |
conn_mod_def::GJ5EnZaCXKc::ZBS1NbwOSuKs667vbTm-6A |
| Retrieve a File Upload |
GET |
/file_uploads/{{fileUploadId}} |
conn_mod_def::GJ5EnYv-JOI::3OO49YDBSvuguIPd1sEB2Q |
| Complete a File Upload (Multi-part) |
POST |
/file_uploads/{{fileUploadId}}/complete |
conn_mod_def::GJ5EnY0nPjY::cswz8LGCSL-shqqXm8IP_g |
| Create a File Upload |
POST |
/file_uploads |
conn_mod_def::GJ5EnYfr70E::3oXOqt0LRV6BRNpVAEZV8g |
| Upload a File to a File Upload (Send) |
POST |
/file_uploads/{{fileUploadId}}/send |
conn_mod_def::GJ5EniTgYAs::BxOVTU7LTUGY3vL8EOzJyw |
Blocks
| Action |
Method |
Path |
Action id |
| Retrieve a Block |
GET |
/blocks/{{blockId}} |
conn_mod_def::GJ5EmvSQ2B0::IaH8E1BaTdygXY8EaTmcOQ |
| Retrieve a Block's Children |
GET |
/blocks/{{blockId}}/children |
conn_mod_def::GJ5Emwl98w0::aNRlxEQlS3yp9jUDqcM4XA |
| Append Block Children (to a Block) |
PATCH |
/blocks/{{blockId}}/children |
conn_mod_def::GJ5Em2aq5jQ::sbJEGMvZT9W8lVCdbtrZZg |
| Delete a Block |
DELETE |
/blocks/{{blockId}} |
conn_mod_def::GJ5EmukZQRs::9n52gAOBTWqqFBBzXTQe-Q |
| Update a Block |
PATCH |
/blocks/{{blockId}} |
conn_mod_def::GJ5EmvcnkcA::xn1Y-4ceTf2zD2MLzXATIg |
DataSources
| Action |
Method |
Path |
Action id |
| Retrieve a Data Source |
GET |
/data_sources/{{dataSourceId}} |
conn_mod_def::GJ5EnLJm9Rs::VnsFKIkySlejecbCNW8OSQ |
| Create a Data Source (Database) |
POST |
/data_sources |
conn_mod_def::GJ5EnDp5kV4::cw2PLhA-Rq28g6SBDB1DSw |
| Query a Data Source’s Pages |
POST |
/data_sources/{{dataSourceId}}/query |
conn_mod_def::GJ5EnL2xERY::ib0N5v41TveieFZQUV-vuQ |
| Update a Data Source |
PATCH |
/data_sources/{{dataSourceId}} |
conn_mod_def::GJ5EnQXxvXk::cZnYjVIiQ86OED40_agalA |
Users
| Action |
Method |
Path |
Action id |
| List All Users |
GET |
/users |
conn_mod_def::GJ5En6XTisE::oVo2r95MStucaDSDfPldWg |
| Retrieve a User |
GET |
/users/{{userId}} |
conn_mod_def::GJ5En51U-AM::ng0tWFVcT7Wca4GDi6j-VA |
| Retrieve Your Token’s Bot User (Me) |
GET |
/users/me |
conn_mod_def::GJ5En-L57E4::ch-B9doqTkC84chVAIz_fQ |
Comments
| Action |
Method |
Path |
Action id |
| List Comments for a Block |
GET |
/comments |
conn_mod_def::GJ5Em_f5GzQ::HIYZgcN1RweyF4AM3CS7HA |
| Retrieve a Comment |
GET |
/comments/{{commentId}} |
conn_mod_def::GJ5EnDOjeBM::HuzPPxNiTveR0fvD6CjOLA |
| Create a Comment |
POST |
/comments |
conn_mod_def::GJ5Em-aukAw::Bp-ioVVBRw6_2tgrs0qbTg |
Databases
| Action |
Method |
Path |
Action id |
| Retrieve a Database |
GET |
/databases/{{databaseId}} |
conn_mod_def::GJ5EnLuVBBM::-wFRC3UCRkyw2E_cRyK8Ig |
| Create a Database |
POST |
/databases |
conn_mod_def::GJ5EnO-sIGI::OyHdDjgwSDWBOWIQDG3s5w |
| Update a Database |
PATCH |
/databases/{{databaseId}} |
conn_mod_def::GJ5EnYZZxd0::ltr2GVaESIyOntrHZbcOXw |
OauthTokens
| Action |
Method |
Path |
Action id |
| Exchange OAuth Authorization Code or Refresh Token for an Access Token (Create a Token) |
POST |
/oauth/token |
conn_mod_def::GJ5EniMEqP4::i83ybb2OQGKh8S5G_yBYhQ |
| Introspect a Token |
POST |
/oauth/introspect |
conn_mod_def::GJ5EniEm9k0::KY1opHdPRFmD0XPnOeNDeg |
| Revoke an OAuth Token |
POST |
/oauth/revoke |
conn_mod_def::GJ5Enhh_z9g::XYRhGHGTRJWsz3-DI-afpQ |
Search
| Action |
Method |
Path |
Action id |
| Search by Title (Search Pages and Data Sources) |
POST |
/search |
conn_mod_def::GJ5En67fz04::-CJAS419SVWm7L2l6brp6A |
DataSourceTemplates
| Action |
Method |
Path |
Action id |
| List a Data Source’s Templates |
GET |
/data_sources/{{dataSourceId}}/templates |
conn_mod_def::GJ5Em_jsBkQ::1-MIrP9fTnG2NeUdFPRYNA |
PagePropertyItems
| Action |
Method |
Path |
Action id |
| Retrieve a Page Property Item |
GET |
/pages/{{pageId}}/properties/{{propertyId}} |
conn_mod_def::GJ5EnuLLMqA::cn-tBE4xRuSjdpm1eyXaTw |
When a call fails
The error comes from Notion, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.
Full catalog: https://www.withone.ai/knowledge/notion
Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.
withoneai