Notion MCP Server

Enables AI assistants to interact with Notion's API for reading, creating, and modifying content through natural language.

Remote serverstreamable-http★ 165

What is the Notion MCP Server?

Enables AI assistants to interact with Notion's API for reading, creating, and modifying content through natural language.

What the server does

Give your AI full read/write access to Notion with one token and one paste. This is an agent-first Notion MCP server: your AI client (Claude Code, Claude Desktop, Cursor, VS Code, Cline, Zed — anything that speaks MCP) can create pages, query databases, append blocks, apply templates, comment, and upload files in natural language.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
AreaOperations
Pagescreate_page, get_page, set_page_title, set_page_property, set_page_properties, archive_page (alias: trash_page), restore_page, search_pages, move_page, get_page
Blocksappend_blocks, get_block, get_block_children, update_block, delete_block, batch_mixed_blocks
Databasescreate_database, query_database, update_database, delete_database
Viewslist_views, get_view, query_view, create_view, update_view, delete_view
Commentslist_comments, add_page_comment, add_discussion_comment, get_comment, update_comment, delete_comment
Userslist_users, get_user, get_bot_user, get_self
Filesupload_file, list_file_uploads, get_file_upload, get_file_url, get_image

How to install the Notion MCP Server

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "notion-mcp-server"
      ],
      "env": {
        "NOTION_TOKEN": "YOUR_NOTION_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
NOTION_TOKENDeclared in the maintainer’s client configuration.Yes

Example prompts to try

  • “Use Notion to Two.”
  • “Use Notion to Rate.”
  • “Use Notion to Self.”

Frequently asked questions

You can create and update pages, manage databases, append blocks, archive content, and more, all through your AI assistant. This streamlines your workflow and automates Notion tasks.