mcp-notion-server

Overview

This MCP server targets the Notion API 2026-03-11 and provides comprehensive tools for interacting with Notion workspaces. It offers both simplified tools for common tasks like reading pages, appending content, and querying data sources, as well as raw API tools for advanced operations. The server supports MCP tools, prompts, resources, structured tool results, and optional MCP Apps like Data Source Explorer and Page Workbench for interactive workflows.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• notion_find

  Search and target discovery for Notion pages and data sources

  Try:Find pages about project planningTry:Search for databases containing customer data
• notion_read_page

  Compact page reading with stable block IDs

  Try:Read the content of my meeting notesTry:Get the full text of the project proposal document
• notion_inspect_data_source

  Inspect schema of a Notion data source or database

  Try:Show me the columns in my task databaseTry:What properties are available in the contacts database?
• notion_query_data_source_by_values

  Query data source items based on specific values

  Try:Find all tasks assigned to meTry:Get all customers from California
• notion_create_data_source_item_from_values

  Create new items in a data source with simple values

  Try:Add a new task to my to-do listTry:Create a customer record for Acme Corp
• notion_append_markdown

  Append Markdown content to a Notion page

  Try:Add a bullet list to my notesTry:Append meeting minutes to the project document
• notion_append_content

  Append structured content to a Notion page

  Try:Add a heading to the top of the documentTry:Insert a to-do list at this position
• notion_update_content

  Update content in a Notion page

  Try:Change the title of this pageTry:Mark this task as complete
• notion_update_content_batch

  Update multiple content blocks in a Notion page

  Try:Update all headings to level 2Try:Mark multiple tasks as complete

Comparable tools

Installation

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@suekou/mcp-notion-server"],
      "env": {
        "NOTION_API_TOKEN": "your-integration-token"
      }
    }
  }
}

FAQ

What Notion API version does this server support?

This server targets the Notion API version 2026-03-11 and uses the current database/data source model.

Can I use this server to manage comments in Notion?

Yes, but you need to enable 'Read comments' and 'Insert comments' capabilities in your Notion integration settings.

Compare mcp-notion-server with