Notion

What is Notion MCP Server?

Notion MCP Server is a Model Context Protocol (MCP) server designed to bridge the gap between Language Models (LMs) and Notion workspaces. It allows LMs to programmatically interact with Notion, performing operations like searching, reading, creating, and updating pages and databases. This facilitates automation and enhanced productivity by enabling LMs to manage information within Notion.

How to use Notion MCP Server?

To use Notion MCP Server, you need Node.js (v16 or higher), a Notion API key, and an MCP-compatible client like Claude Desktop. After cloning the repository and installing dependencies, you'll set up your Notion API key in a .env file or as an environment variable. The server then needs to be built using npm run build. For integration with Claude Desktop, you'll configure its mcpServers setting to point to the built server. You also need to create a Notion integration with appropriate permissions and connect it to the Notion pages you wish to access.

Key Features of Notion MCP Server

Page Operations

• Search: Efficiently search through your Notion workspace.
• Create: Generate new pages with rich markdown content.
• Read: Access page content with clean formatting.
• Update: Modify existing pages.
• Comments: Add and retrieve comments on pages.
• Block-level operations: Update and delete individual blocks within pages.

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: Create new databases and manage existing ones.
• Add and Update Items: Add and modify items within databases.
• Query: Filter and sort database entries.
• Property Support: Comprehensive support for various property types including Title, Rich text, Number, Select, Multi-select, Date, Checkbox, and more.

Use Cases of Notion MCP Server

• Automated Content Generation: LMs can create new Notion pages or update existing ones with generated content.
• Information Retrieval: LMs can search and retrieve specific information from Notion for various tasks.
• Task Management: LMs can interact with Notion databases to manage tasks, update statuses, and assign responsibilities.
• Knowledge Base Management: Automate the organization and updating of knowledge bases within Notion.
• Integration with AI Assistants: Enable AI assistants (like Claude) to directly interact with and manage Notion data, enhancing their capabilities for productivity and information management.

FAQ from Notion MCP Server

Q: What are the prerequisites for running Notion MCP Server? A: You need Node.js (v16 or higher), a Notion API key, and an MCP-compatible client (e.g., Claude Desktop).

Q: How do I set up my Notion API key? A: You can set it up in a .env file (e.g., echo "NOTION_API_KEY=your_notion_api_key_here" > .env) or export it directly as an environment variable.

Q: What Notion permissions are required for the integration? A: For the integration, you should configure permissions for Content (Read, Update, Insert), Comments (Read, Create), and User Information (Read).

Q: Can I use Notion MCP Server with other MCP-compatible clients besides Claude Desktop? A: Yes, it is designed to work with any MCP-compatible client.

Q: Does Notion MCP Server support all Notion block types? A: It supports enhanced markdown with various block types, including headings, code blocks, todo items, blockquotes, dividers, images, and nested bullet points. It also supports block-level operations for updating and deleting.

Q: How can I contribute to the Notion MCP Server project? A: You can contribute by forking the repository, creating a feature branch, and submitting a Pull Request.

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

1. Clone the repository:

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

2. Install dependencies:

npm install

3. 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

4. Build the server:

npm run build

🔧 Configuration

Claude Desktop Setup

1. 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"
            }
        }
    }
}

2. 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

1. Visit Notion Integrations
2. Click "New integration"
3. Configure permissions:
   • Content: Read, Update, Insert
   • Comments: Read, Create
   • User Information: Read

Connecting Pages

1. Open your Notion page
2. Click "..." menu → "Connections"
3. Add your integration
4. 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:

1. Fork the repository
2. Create a feature branch
3. 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