Happy slice of mcp pizzaMCP.pizza

mcp-notion-server

MCP.Pizza Chef: suekou

Notion is where a lot of people keep notes, documents and trackers. This connection lets an assistant search for a page or database, read it with the formatting intact, add paragraphs, headings, lists, to-dos, quotes and code blocks, and create or update entries in a database. Setup means making a connection inside Notion, choosing which pages it is allowed to touch, and pasting the secret it gives you into your app's settings.

Data
Notes
Writing

Use This MCP server To

Find the meeting note I wrote last Tuesday Add today's decisions to an existing project page Create a new entry in my reading list database Turn a rough draft into a tidy formatted page Tick off the to-dos I finished this week Summarize a whole database of open tasks

README

Notion MCP Server

AI-friendly MCP server for the Notion API. It helps agents find, read, query, and update Notion workspaces while keeping responses compact enough for day-to-day AI workflows.

This server targets the Notion API 2026-03-11 and uses the current database/data source model. It exposes MCP tools, prompts, resources, structured tool results, and optional MCP Apps for interactive Notion workflows.

Highlights

  • Search and target discovery with notion_find.
  • Compact page reading with stable block IDs via notion_read_page.
  • Data source schema inspection with notion_inspect_data_source.
  • Schema-aware data source querying and item creation with simple values.
  • Simple page editing tools for paragraphs, headings, lists, todos, quotes, callouts, code blocks, dividers, and safe Markdown append.
  • Raw Notion API tools for advanced block, page, database, data source, comment, and user operations.
  • Optional MCP Apps: Data Source Explorer and Page Workbench.

Quick Start

Add this server to an MCP host such as Claude Desktop:

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

Restart your MCP host after saving the configuration.

Setup Guide

1. Create a Notion integration

Open the Notion integrations dashboard, then create a new internal integration.

Internal connections New connections

mcp-notion-server FAQ

Do I need a secret from Notion?
Yes. You create a connection in Notion's settings and paste its secret into your app.
Can it see my whole workspace?
Only the pages and databases you deliberately share with the connection you created.
Can I use this to write meeting notes straight into Notion?
Yes — it can create a fresh page or add to one you already have.
Which apps does it work in?
Claude Desktop and Cursor are documented, and other apps that support these connections work the same way.
How hard is setup?
A few clicks inside Notion, then one short settings block pasted into your app.
Could it change something by accident?
It only gets the permissions you grant. Leave out the update permission and it can read but not edit.