notion-mcp-server

sargonpiraev/notion-mcp-server

3.2

If you are the rightful owner of notion-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Notion API MCP Server is a tool designed to facilitate seamless integration of AI assistants with the Notion API, enabling automated workflows and real-time data access.

Tools
19
Resources
0
Prompts
0

Notion API MCP Server 🔧

npm version npm downloads license pipeline status smithery badge MCP Compatible Join Discord

Features

  • 🔌 Seamless AI Integration: Direct Notion API API access from Claude, Cursor, and VS Code
  • 🤖 Automated Workflows: Automate Notion API operations and data access
  • 📊 Complete API Coverage: 19+ tools covering all major Notion API features
  • ⚡ Real-time Access: Access Notion API data instantly from AI assistants
  • 🔧 Professional Integration: Error handling, validation, and comprehensive logging

Get Your Credentials

Before installation, you'll need a Notion API API key:

  1. Open Notion API app or web interface
  2. Go to Settings → Account → API Access
  3. Generate new API key or copy existing one
  4. Save this key for the installation steps below

Requirements

  • Node.js >= v18.0.0
  • Notion API API key
  • Cursor, VS Code, Claude Desktop or another MCP Client

Installation

Installing via Smithery

To install Notion API MCP Server for any client automatically via Smithery:

npx -y @smithery/cli@latest install @sargonpiraev/notion-mcp-server --client <CLIENT_NAME>
Install in Cursor
Cursor One-Click Installation

Install MCP Server

Manual Configuration

Add to your Cursor ~/.cursor/mcp.json file:

{
  "mcpServers": {
    "notion-mcp-server": {
      "command": "npx",
      "args": ["-y", "@sargonpiraev/notion-mcp-server"],
      "env": {
        "NOTION_API_TOKEN": "your-notion_api_token"
      }
    }
  }
}
Install in VS Code

Or add manually to your VS Code settings:

"mcp": {
  "servers": {
    "notion-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@sargonpiraev/notion-mcp-server"],
      "env": {
        "NOTION_API_TOKEN": "your-notion_api_token"
      }
    }
  }
}
Install in Claude Desktop

Add to your claude_desktop_config.json:

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

Available Tools

  • get-user: Retrieve a user
  • get-users: List all users
  • get-self: Retrieve your token's bot user
  • post-database-query: Query a database
  • post-search: Search by title
  • get-block-children: Retrieve block children
  • patch-block-children: Append block children
  • retrieve-a-block: Retrieve a block
  • update-a-block: Update a block
  • delete-a-block: Delete a block
  • retrieve-a-page: Retrieve a page
  • patch-page: Update page properties
  • post-page: Create a page
  • create-a-database: Create a database
  • update-a-database: Update a database
  • retrieve-a-database: Retrieve a database
  • retrieve-a-page-property: Retrieve a page property item
  • retrieve-a-comment: Retrieve comments
  • create-a-comment: Create comment

Total: 19 tools available 🎯

Support This Project

Hi! I'm Sargon, a software engineer passionate about AI tools and automation. I create open-source MCP servers to help developers integrate AI assistants with their favorite services.

Your support helps me continue developing and maintaining these tools, and motivates me to create new integrations that make AI assistants even more powerful! 🚀

Support on Boosty

Connect with Author