Notion MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on Notion: 13 typed functions through one MCP server. No Notion API key needed.
- Site
- notion.com
- Functions
- 13
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Notion alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/notionOne MCP server for Notion and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
getDatabaseRead a Notion database's schema.Arguments
Name Type Required databaseIdstringYes Returns
NotionObject// Notion's own objects (page, database, block, user, comment), exactly as api.notion.com returns them. type NotionObject = { object: string; id: string } & Record<string, unknown>;HTTP endpoint
POST https://api.bowmark.ai/v1/sites/notion/getDatabaseCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.notion.getDatabase({ databaseId: "00000000000000000000000000000000" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.notion.getDatabase({"databaseId": "00000000000000000000000000000000"}))curl -X POST https://api.bowmark.ai/v1/sites/notion/getDatabase \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"databaseId":"00000000000000000000000000000000"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.notion.getDatabase({ databaseId: "00000000000000000000000000000000" });getMeThe bot user your integration token acts as, and its workspace.Arguments
None.
Returns
NotionObject// Notion's own objects (page, database, block, user, comment), exactly as api.notion.com returns them. type NotionObject = { object: string; id: string } & Record<string, unknown>;HTTP endpoint
POST https://api.bowmark.ai/v1/sites/notion/getMeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.notion.getMe();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.notion.getMe())curl -X POST https://api.bowmark.ai/v1/sites/notion/getMe \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.notion.getMe();getPageRead one Notion page's properties (title, parent, url, database fields).Arguments
Name Type Required pageIdstringYes Returns
NotionObject// Notion's own objects (page, database, block, user, comment), exactly as api.notion.com returns them. type NotionObject = { object: string; id: string } & Record<string, unknown>;HTTP endpoint
POST https://api.bowmark.ai/v1/sites/notion/getPageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.notion.getPage({ pageId: "00000000000000000000000000000000" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.notion.getPage({"pageId": "00000000000000000000000000000000"}))curl -X POST https://api.bowmark.ai/v1/sites/notion/getPage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"pageId":"00000000000000000000000000000000"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.notion.getPage({ pageId: "00000000000000000000000000000000" });getPageContentRead the content of a Notion page.Arguments
Name Type Required argsNotionPageContentArgsYes // A page is a block, so `blockId` reads any block's children: the runtime reads either. type NotionPageContentArgs = | { pageId: string; limit?: number; cursor?: string } | { blockId: string; limit?: number; cursor?: string };Returns
NotionList<NotionObject>interface NotionList<T = Record<string, unknown>> { results: T[]; nextCursor: string | null; hasMore: boolean } // Notion's own objects (page, database, block, user, comment), exactly as api.notion.com returns them. type NotionObject = { object: string; id: string } & Record<string, unknown>;HTTP endpoint
POST https://api.bowmark.ai/v1/sites/notion/getPageContentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.notion.getPageContent({ pageId: "00000000000000000000000000000000" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.notion.getPageContent({"pageId": "00000000000000000000000000000000"}))curl -X POST https://api.bowmark.ai/v1/sites/notion/getPageContent \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"pageId":"00000000000000000000000000000000"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.notion.getPageContent({ pageId: "00000000000000000000000000000000" });listCommentsRead the open comments on a Notion page.Arguments
Name Type Required argsNotionCommentsArgsYes // Every id accepts a UUID (dashes optional) or a notion.so URL ending in one. limit is 1-100 (default 20); cursor is the previous call's nextCursor. type NotionPaging = { limit?: number; cursor?: string }; type NotionPageRef = { pageId: string }; type NotionCommentsArgs = NotionPageRef & NotionPaging;Returns
NotionList<NotionObject>interface NotionList<T = Record<string, unknown>> { results: T[]; nextCursor: string | null; hasMore: boolean } // Notion's own objects (page, database, block, user, comment), exactly as api.notion.com returns them. type NotionObject = { object: string; id: string } & Record<string, unknown>;HTTP endpoint
POST https://api.bowmark.ai/v1/sites/notion/listCommentsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.notion.listComments({ pageId: "00000000000000000000000000000000" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.notion.listComments({"pageId": "00000000000000000000000000000000"}))curl -X POST https://api.bowmark.ai/v1/sites/notion/listComments \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"pageId":"00000000000000000000000000000000"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.notion.listComments({ pageId: "00000000000000000000000000000000" });listUsersList the members and bots of your Notion workspace.Arguments
Name Type Required limitnumberNo cursorstringNo Returns
NotionList<NotionObject>interface NotionList<T = Record<string, unknown>> { results: T[]; nextCursor: string | null; hasMore: boolean } // Notion's own objects (page, database, block, user, comment), exactly as api.notion.com returns them. type NotionObject = { object: string; id: string } & Record<string, unknown>;HTTP endpoint
POST https://api.bowmark.ai/v1/sites/notion/listUsersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.notion.listUsers({ limit: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.notion.listUsers({"limit": 1}))curl -X POST https://api.bowmark.ai/v1/sites/notion/listUsers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"limit":1}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.notion.listUsers({ limit: 1 });queryDatabaseList the rows of a Notion database, with Notion's own filter and sorts.Arguments
Name Type Required argsNotionQueryArgsYes // Every id accepts a UUID (dashes optional) or a notion.so URL ending in one. limit is 1-100 (default 20); cursor is the previous call's nextCursor. type NotionPaging = { limit?: number; cursor?: string }; type NotionDatabaseRef = { databaseId: string }; type NotionQueryArgs = NotionDatabaseRef & NotionPaging & { filter?: Record<string, unknown>; sorts?: Record<string, unknown>[] };Returns
NotionList<NotionObject>interface NotionList<T = Record<string, unknown>> { results: T[]; nextCursor: string | null; hasMore: boolean } // Notion's own objects (page, database, block, user, comment), exactly as api.notion.com returns them. type NotionObject = { object: string; id: string } & Record<string, unknown>;HTTP endpoint
POST https://api.bowmark.ai/v1/sites/notion/queryDatabaseCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.notion.queryDatabase({ databaseId: "00000000000000000000000000000000" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.notion.queryDatabase({"databaseId": "00000000000000000000000000000000"}))curl -X POST https://api.bowmark.ai/v1/sites/notion/queryDatabase \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"databaseId":"00000000000000000000000000000000"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.notion.queryDatabase({ databaseId: "00000000000000000000000000000000" });searchSearch your Notion workspace's pages and databases by title.Arguments
Name Type Required argsNotionSearchArgsNo // Every id accepts a UUID (dashes optional) or a notion.so URL ending in one. limit is 1-100 (default 20); cursor is the previous call's nextCursor. type NotionPaging = { limit?: number; cursor?: string }; type NotionSearchArgs = NotionPaging & { query?: string; filter?: "page" | "database"; spaceId?: string };Returns
NotionList<NotionObject>interface NotionList<T = Record<string, unknown>> { results: T[]; nextCursor: string | null; hasMore: boolean } // Notion's own objects (page, database, block, user, comment), exactly as api.notion.com returns them. type NotionObject = { object: string; id: string } & Record<string, unknown>;HTTP endpoint
POST https://api.bowmark.ai/v1/sites/notion/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.notion.search({ limit: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.notion.search({"limit": 1}))curl -X POST https://api.bowmark.ai/v1/sites/notion/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"limit":1}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.notion.search({ limit: 1 });systemStatusNotion's live system status.Arguments
None.
Returns
NotionSystemStatusinterface NotionIncident { name: string; status: string; impact: string | null; createdAt: string | null; resolvedAt: string | null; latestUpdate: string | null } interface NotionSystemStatus { status: string; indicator: string; components: Array<{ name: string; status: string }>; recentIncidents: NotionIncident[] }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/notion/systemStatusCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.notion.systemStatus();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.notion.systemStatus())curl -X POST https://api.bowmark.ai/v1/sites/notion/systemStatus \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.notion.systemStatus();
appendBlocksAdd text (or any blocks) to the end of a Notion page.Arguments
Name Type Required argsNotionAppendArgsYes type NotionPageRef = { pageId: string }; type NotionAppendArgs = NotionPageRef & { text?: string; children?: Record<string, unknown>[] };Returns
NotionList<NotionObject>interface NotionList<T = Record<string, unknown>> { results: T[]; nextCursor: string | null; hasMore: boolean } // Notion's own objects (page, database, block, user, comment), exactly as api.notion.com returns them. type NotionObject = { object: string; id: string } & Record<string, unknown>;HTTP endpoint
POST https://api.bowmark.ai/v1/sites/notion/appendBlocksCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.notion.appendBlocks("<args>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.notion.appendBlocks("<args>"))curl -X POST https://api.bowmark.ai/v1/sites/notion/appendBlocks \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":"<args>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.notion.appendBlocks("<args>");createCommentComment on a Notion page, or reply in an existing discussion.Arguments
Name Type Required argsNotionCreateCommentArgsYes type NotionCreateCommentArgs = ({ pageId: string } | { discussionId: string }) & { text: string };Returns
NotionObject// Notion's own objects (page, database, block, user, comment), exactly as api.notion.com returns them. type NotionObject = { object: string; id: string } & Record<string, unknown>;HTTP endpoint
POST https://api.bowmark.ai/v1/sites/notion/createCommentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.notion.createComment("<args>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.notion.createComment("<args>"))curl -X POST https://api.bowmark.ai/v1/sites/notion/createComment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":"<args>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.notion.createComment("<args>");createPageCreate a Notion page under a page or as a new row in a database, with optional text.Arguments
Name Type Required argsNotionCreatePageArgsYes // text: plain text, one paragraph per line. children: raw Notion block objects instead. type NotionCreatePageArgs = ({ parentPageId: string } | { parentDatabaseId: string }) & { title?: string; properties?: Record<string, unknown>; text?: string; children?: Record<string, unknown>[] };Returns
NotionObject// Notion's own objects (page, database, block, user, comment), exactly as api.notion.com returns them. type NotionObject = { object: string; id: string } & Record<string, unknown>;HTTP endpoint
POST https://api.bowmark.ai/v1/sites/notion/createPageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.notion.createPage("<args>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.notion.createPage("<args>"))curl -X POST https://api.bowmark.ai/v1/sites/notion/createPage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":"<args>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.notion.createPage("<args>");updatePageEdit a Notion page, rename it, set database properties, archive or restore it.Arguments
Name Type Required argsNotionUpdatePageArgsYes type NotionPageRef = { pageId: string }; type NotionUpdatePageArgs = NotionPageRef & { title?: string; properties?: Record<string, unknown>; archived?: boolean; icon?: Record<string, unknown>; cover?: Record<string, unknown> };Returns
NotionObject// Notion's own objects (page, database, block, user, comment), exactly as api.notion.com returns them. type NotionObject = { object: string; id: string } & Record<string, unknown>;HTTP endpoint
POST https://api.bowmark.ai/v1/sites/notion/updatePageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.notion.updatePage("<args>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.notion.updatePage("<args>"))curl -X POST https://api.bowmark.ai/v1/sites/notion/updatePage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":"<args>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.notion.updatePage("<args>");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/notion/<function> - OpenAPI
/v1/sites/notion/openapi.json