Notion MCP Server

A Model Context Protocol (MCP) server that provides seamless integration with Notion. This server enables Language Models to interact with your Notion workspace through standardized tools for searching, reading, creating, and updating pages and databases.

🌟 Key Features

Page Operations

🔍 Search through your Notion workspace
📝 Create new pages with rich markdown content
📖 Read page content with clean formatting
🔄 Update existing pages
💬 Add and retrieve comments
🧱 Block-level operations (update, delete)

Enhanced Markdown Support

Multiple heading levels (H1-H3)
Code blocks with language support
Interactive todo items with checkbox states
Blockquotes with multi-line support
Horizontal dividers
Images with captions
Nested bullet points

Database Operations

Create and manage databases
Add and update database items
Query with filters and sorting
Support for various property types:
- Title, Rich text, Number
- Select, Multi-select
- Date, Checkbox
- And more!

🚀 Getting Started

Prerequisites

Node.js (v16 or higher)
Notion API key
MCP-compatible client (e.g., Claude Desktop)

Installation

Clone the repository:

git clone https://github.com/v-3/notion-server.git
cd notion-server

Install dependencies:

npm install

Set up your environment:

# Create .env file
echo "NOTION_API_KEY=your_notion_api_key_here" > .env

# Or export directly
export NOTION_API_KEY=your_notion_api_key_here

Build the server:

npm run build

🔧 Configuration

Claude Desktop Setup

Update your Claude Desktop configuration (claude_desktop_config.json):

{
    "mcpServers": {
        "notion": {
            "command": "node",
            "args": ["/absolute/path/to/notion-server/build/index.js"],
            "env": {
                "NOTION_API_KEY": "your_notion_api_key_here"
            }
        }
    }
}

Restart Claude Desktop to apply changes

🛠️ Available Tools

Page Operations

// Search pages
{
    query: string // Search query
}

// Read page
{
    pageId: string // ID of the page to read
}

// Create page
{
    title?: string,      // Page title
    content?: string,    // Page content in markdown
    parentPageId: string // Parent page ID
    properties?: object  // For database items
}

// Update page
{
    pageId: string,   // Page ID to update
    content: string,  // New content
    type?: string    // Content type
}

Database Operations

// Create database
{
    parentPageId: string,
    title: string,
    properties: object
}

// Query database
{
    databaseId: string,
    filter?: object,
    sort?: object
}

🔐 Setting Up Notion Access

Creating an Integration

Visit Notion Integrations
Click "New integration"
Configure permissions:
- Content: Read, Update, Insert
- Comments: Read, Create
- User Information: Read

Connecting Pages

Open your Notion page
Click "..." menu → "Connections"
Add your integration
Repeat for other pages as needed

📝 Usage Examples

Creating a Page

const result = await notion.create_page({
  parentPageId: "page_id",
  title: "My Page",
  content: "# Welcome\nThis is a test page."
});

Querying a Database

const result = await notion.query_database({
  databaseId: "db_id",
  filter: {
    property: "Status",
    select: {
      equals: "In Progress"
    }
  }
});

🤝 Contributing

Contributions are welcome! Please:

Fork the repository
Create a feature branch
Submit a Pull Request

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

This project has been significantly improved by sweir1/notion-server, who has made following updates:

Enhanced markdown support with more block types
Comprehensive database operations
Improved error handling and debugging
Better property handling for database items
Cleaner page output formatting

To use sweir1's version, you can clone their repository:

git clone https://github.com/sweir1/notion-server.git

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables Language Models to interact with Notion workspaces through standardized tools for searching, reading, creating, and updating pages and databases.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Notion MCP Server
orbit-logistics
-
security
F
license
-
quality
Enables interaction with Notion through the Notion API by exposing it as tools for LLMs, allowing operations like reading, creating, updating, and deleting Notion pages seamlessly via natural language.
Last updated -
6
22
Notion MCP Server
ghubnerr
-
security
A
license
-
quality
A Model Context Protocol server that provides a standardized interface for AI models to access, query, and modify content in Notion workspaces.
Last updated -
184
4
MIT License
Notion MCP Server
gendosu
A
security
A
license
A
quality
Enables AI agents to interact with Notion workspaces through the Notion API. Supports reading, writing, commenting, and managing Notion pages and databases with optimized token consumption for AI agents.
Last updated -
19
12,505
MIT License
Notion MCP Server
589411
-
security
F
license
-
quality
Enables interaction with Notion workspaces through the Notion API. Provides tools to search, read, create, and update Notion pages and databases with real-time synchronization.
Last updated -
184

View all related MCP servers

Notion MCP Server

Notion MCP Server

🌟 Key Features

Page Operations

Enhanced Markdown Support

Database Operations

🚀 Getting Started

Prerequisites

Installation

🔧 Configuration

Claude Desktop Setup

🛠️ Available Tools

Page Operations

Database Operations

🔐 Setting Up Notion Access

Creating an Integration

Connecting Pages

📝 Usage Examples

Creating a Page

Querying a Database

🤝 Contributing

📜 License

🙏 Acknowledgments

Related Resources

Related MCP Servers