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.

Functions
13
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just Notion

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/notion
Every site

One MCP server for Notion and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

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

Read 9
  • getDatabaseRead a Notion database's schema.

    Arguments

    NameTypeRequired
    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/getDatabase

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/getMe

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.notion.getMe();
  • getPageRead one Notion page's properties (title, parent, url, database fields).

    Arguments

    NameTypeRequired
    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/getPage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.notion.getPage({ pageId: "00000000000000000000000000000000" });
  • getPageContentRead the content of a Notion page.

    Arguments

    NameTypeRequired
    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/getPageContent

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.notion.getPageContent({ pageId: "00000000000000000000000000000000" });
  • listCommentsRead the open comments on a Notion page.

    Arguments

    NameTypeRequired
    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/listComments

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.notion.listComments({ pageId: "00000000000000000000000000000000" });
  • listUsersList the members and bots of your Notion workspace.

    Arguments

    NameTypeRequired
    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/listUsers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.notion.listUsers({ limit: 1 });
  • queryDatabaseList the rows of a Notion database, with Notion's own filter and sorts.

    Arguments

    NameTypeRequired
    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/queryDatabase

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.notion.queryDatabase({ databaseId: "00000000000000000000000000000000" });
  • systemStatusNotion's live system status.

    Arguments

    None.

    Returns NotionSystemStatus

    interface 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/systemStatus

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.notion.systemStatus();
Act 4
  • appendBlocksAdd text (or any blocks) to the end of a Notion page.

    Arguments

    NameTypeRequired
    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/appendBlocks

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.notion.appendBlocks("<args>");
  • createCommentComment on a Notion page, or reply in an existing discussion.

    Arguments

    NameTypeRequired
    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/createComment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    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/createPage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.notion.createPage("<args>");
  • updatePageEdit a Notion page, rename it, set database properties, archive or restore it.

    Arguments

    NameTypeRequired
    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/updatePage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.notion.updatePage("<args>");

Use it from code