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

Install verified 6 tools

Productivity

Last updated September 4, 2026 Β· By MCPizy team

Pages, databases, search in Notion workspace

Official homepage
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 29 days ago Β· 4,600 stars Β· MIT licence Β· 187 open issues

Read the full audit on CheckMCP

Install Notion

Via MCPizy CLI (recommended):
mcpizy install notion
Or run directly:
npx -y @notionhq/notion-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

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

Alternatives to Notion

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

Frequently asked questions

What is the Notion MCP server?

Notion is listed as an Productivity Model Context Protocol server whose documented purpose is to let an MCP-compatible agent pages, databases, search in Notion workspace. Client support, permissions and authentication remain specific to the upstream project.

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/notion-mcp-server` and restarting Claude Code.

Does MCPizy charge to view or install Notion MCP?

No. Reading this profile and copying its install guidance is free. Upstream software, API, account or usage costs are separate, and licence coverage should be checked from the linked source when available.

Does Notion MCP work with Cursor and Windsurf?

The MCP standard is supported by those clients, but a specific server can still have client-specific setup or transport limits. Use the configuration shown on this page when present and verify the upstream instructions before installation.

What can I do with Notion MCP?

Its documented purpose is to let an MCP-compatible agent pages, databases, search in Notion workspace. The exact tools, permissions and write capabilities depend on the server version and configuration shown by the upstream project.

Compare before you commit

Put this server beside an alternative, or return to the full evidence directory.

Compare MCP serversBack to directory