Notion MCP server for AI agents

Search, read, create and edit Notion pages, databases and comments.

Auth
OAuth 2.0 (sign in with the app) · Access token
Tools
14
Triggers
0
Category
Productivity, Documents
Connect Notion www.notion.so

Tools and triggers

  • Search pages and databases

    NOTION_SEARCH

    Searches page and database titles in everything shared with the integration. Leave `query` empty to list recently edited items.read-only

  • Get a page

    NOTION_GET_PAGE

    Returns a page's properties and metadata. Use Get block children for the page's content.read-only

  • Create a page

    NOTION_CREATE_PAGE

    Creates a page under a page or as a row in a database. Under a page only the title property is allowed; in a database, properties must match its schema.

  • Update page properties

    NOTION_UPDATE_PAGE

    Changes a page's property values, icon or cover. Properties not mentioned stay as they are.destructive

  • Archive a page

    NOTION_ARCHIVE_PAGE

    Moves a page to the trash. It can be restored from Notion's trash.destructive

  • Get block children

    NOTION_GET_BLOCK_CHILDREN

    Lists the content blocks inside a page or block. Pass a page id to read the page body.read-only

  • Append blocks

    NOTION_APPEND_BLOCK_CHILDREN

    Adds content blocks (paragraphs, headings, to-dos, …) to the end of a page or block, or after a given block.

  • Delete a block

    NOTION_DELETE_BLOCK

    Moves a block (a paragraph, a list item, a child page, …) to the trash.destructive

  • Get a database

    NOTION_GET_DATABASE

    Returns a database's title and property schema (names, types and select options).read-only

  • Query a database

    NOTION_QUERY_DATABASE

    Returns the rows of a database, optionally filtered and sorted with Notion's filter syntax.read-only

  • Create a database

    NOTION_CREATE_DATABASE

    Creates an inline database inside a page. Every database needs exactly one title property.

  • List users

    NOTION_LIST_USERS

    Lists the people and bots in the workspace.read-only

  • Add a comment

    NOTION_CREATE_COMMENT

    Comments on a page, or replies in an existing discussion thread. Give either `page_id` or `discussion_id`.

  • Get comments

    NOTION_GET_COMMENTS

    Lists the open comments on a page or block.read-only

Connect via MCP

Create an MCP server for Notion in the dashboard, then add its URL to your client. This is the Claude Code command; the client guide has the others.

terminal
claude mcp add --transport http notion \
  "https://www.prompt-tm.com/mcp/<server id>?user_id=<your user>" \
  --header "x-api-key: ptm_…"

Connect via REST

Run a tool with one request. The response is { data, error, successful, log_id } for every tool.

terminal
curl -X POST https://www.prompt-tm.com/api/v3/tools/execute/NOTION_SEARCH \
  -H "x-api-key: $PROMPT_TM_KEY" -H "content-type: application/json" \
  -d '{ "user_id": "alice", "arguments": {} }'

Notion questions

Other toolkits