Back
Directory/Notion

TL;DR

Notion is a Productivity MCP server that lets Claude Code, Cursor, Windsurf and any MCP-compatible AI agent pages, databases, search in Notion workspace. Install in 1 minute with mcpizy install notion.

📝

Notion

Verified 6 tools Supports hosted execution →

Productivity

Last updated August 9, 2026 · By MCPizy team

Pages, databases, search in Notion workspace

Official homepage

Run Notion without any local install

Connect your Notion account once — MCPizy stores the credentials encrypted and uses them whenever you run a recipe in managed mode.

Checking connection…
A

Repo audit: 90/100 — actively maintained, documented and licensed

Scored on licence, adoption, maintenance and documentation of makenotion/notion-mcp-server. We show the grade whether it flatters the server or not.

last commit 13 days ago · 4,579 stars · MIT licence · 182 open issues

Read the full audit on CheckMCP

Install Notion

Via MCPizy CLI (recommended):
mcpizy install notion
Or run directly:
npx -y @notionhq/mcp-server
View on GitHub

Tools exposed

6 tools available
search

Search pages and databases across the workspace

Inputs

  • querystringrequired
fetch

Fetch the full content of a page or database by ID

Inputs

  • idstringrequired
create_pages

Create one or more pages in a database or under a parent

Inputs

  • parentobjectrequired
  • pagesobject[]required
update_page

Update a page's properties or content

Inputs

  • page_idstringrequired
  • propertiesobjectoptional
create_database

Create a new database with a schema

Inputs

  • parentobjectrequired
  • titlestringrequired
  • propertiesobjectrequired
create_comment

Add a comment to a page

Inputs

  • page_idstringrequired
  • textstringrequired

Configuration

Works identically across clients. Only the config file path differs.

Claude Code~/.claude.json
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "NOTION_API_KEY": "ntn_..."
      }
    }
  }
}
Cursor.cursor/mcp.json
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "NOTION_API_KEY": "ntn_..."
      }
    }
  }
}
Windsurf~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "NOTION_API_KEY": "ntn_..."
      }
    }
  }
}

Authentication setup

  1. 1

    Create an integration and copy the internal integration secret

    Get it NOTION_API_KEY
  2. 2

    Share the pages or databases you want accessible with the integration

    Get it

What you can do with Notion MCP

Paste any of these prompts into Claude Code, Cursor or another MCP-compatible client.

“Search my Notion for pages mentioning 'Q2 roadmap' and summarise them”

Uses: search, fetch

“Create a new page in my Tasks database titled 'Review PR #42'”

Uses: create_pages

“Add the latest meeting notes to my Engineering workspace”

Uses: create_pages

“Update page abc123 and mark its Status as Done”

Uses: update_page

Works with

Claude Code
Claude Desktop
Cursor
Windsurf
VS Code + Copilot
Any MCP Client

More Productivity MCPs

📅

Monday.com

Work management and project tracking

💎

Obsidian

Access and manage Obsidian vault

🌧️

Raindrop

Manage bookmarks and web collections

✅

Todoist

Task management with Todoist API

Alternatives to Notion

If Notion doesn't fit your stack, these Productivity MCP servers solve similar problems.

📅

Google Calendar

Calendar events and scheduling

📂

Google Drive

File management in Google Drive

📊

Airtable

Read and write data to Airtable bases

Key Takeaways

  • Notion exposes 6 tools for productivity workflows in Claude Code, Cursor and Windsurf.
  • Authentication: 2 steps (NOTION_API_KEY).
  • Install in 1 command: mcpizy install notion — config written to your client automatically.
  • Free and open source (GitHub source linked above) — verified compatible with every MCP client (Claude Code, Claude Desktop, Cursor, Windsurf, VS Code + Copilot).
  • Best use case: "Search my Notion for pages mentioning 'Q2 roadmap' and summarise them".

Frequently asked questions

What is the Notion MCP server?

The Notion MCP server is an Productivity Model Context Protocol server that lets Claude Code, Cursor, Windsurf, VS Code with Copilot, and other MCP-compatible AI agents pages, databases, search in Notion workspace. It exposes Notion's capabilities as tools the AI can call directly from your editor or CLI.

How do I install Notion MCP with Claude Code?

The fastest way is the MCPizy CLI: run `mcpizy install notion` and MCPizy will add the server to your `.claude.json` automatically. You can also install it manually by adding an entry under `mcpServers` in `.claude.json` with the command `npx -y @notionhq/mcp-server` and restarting Claude Code.

Is Notion MCP free?

Yes. The Notion MCP server is free and open source (see the GitHub repository linked on this page). You may still need a Notion account or API key to connect the server to the underlying service, but the MCP layer itself has no MCPizy subscription cost.

Does Notion MCP work with Cursor and Windsurf?

Yes. Any MCP-compatible client works — including Claude Code, Claude Desktop, Cursor (via `.cursor/mcp.json`), Windsurf, VS Code with Copilot Chat, and custom agents built on the MCP SDK. The same install command targets all of them; only the config file path differs.

What can I do with Notion MCP?

Once installed, your AI agent can pages, databases, search in Notion workspace directly inside your conversation. Typical use cases include asking Claude Code or Cursor to run Notion operations, inspect results, chain Notion with other MCP servers (see our Workflow Recipes), and automate repetitive productivity tasks without leaving your editor.

Manage all your MCPs in one place

Monitor usage, track costs, and discover new MCPs.

Get Started Free