Notion Server

🚀 Notion MCP Server

A Model Context Protocol (MCP) server that seamlessly integrates with Notion. This server enables language models to search, read, create, and update pages and databases in the workspace through standardized tools.

✨ Features

Page Operations

• 🔍 Search across the entire Notion workspace
• 📝 Create new pages with rich Markdown content
• 📖 Read page content in a clean format
• 🔄 Update existing pages
• 💬 Add and retrieve comments
• 🧱 Block-level operations (update, delete)

Enhanced Markdown Support

• Multi-level headings (H1 - H3)
• Code blocks with language support
• Interactive to-dos with checkbox status
• Quotes with multi-line support
• Horizontal dividers
• Images with captions
• Nested bullet points

Database Operations

• Create and manage databases
• Add and update database items
• Query using filters and sorting
• Support for various property types:
  • Title, rich text, number
  • Single select, multi select
  • Date, checkbox
  • And more!

🚀 Quick Start

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 the environment:

# Create a .env file
echo "NOTION_API_KEY=Your Notion API Key" > .env

# Or export directly
export NOTION_API_KEY=Your Notion API Key

4. Build the server:

npm run build

🔧 Configuration

Claude Desktop Setup

1. Update your Claude Desktop configuration file (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"
            }
        }
    }
}

2. Restart Claude Desktop to apply the changes.

💻 Usage Examples

Page Operations

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

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

// Create a page
{
    title?: string,      // Page title
    content?: string,    // Page content (Markdown format)
    parentPageId: string // Parent page ID
    properties?: object  // Database item properties
}

// Update a page
{
    pageId: string,   // ID of the page to update
    content: string   // New content (Markdown format)
}

Database Operations

// Create a database item
{
    title: string      // Item title
    content?: string  // Optional content (Markdown format)
    properties: object // Properties, e.g., { "Task Status": "Incomplete" }
}

// Update a database item
{
    pageId: string   // ID of the page to update
    properties: object // New property values, e.g., { "Task Status": "Completed" }
}

📚 Documentation

1. Initialize the project:

   • Clone the repository and install dependencies: git clone https://github.com/v-3/notion-server.git && cd notion-server && npm install

2. Configure environment variables:

   • Create a .env file and add NOTION_API_KEY=Your API Key

3. Start the server:

   • Run at the project root: npm start

4. Use the tools:

   • Send a POST request to /api/pages to create a page or database item
   • Send a PUT request to /api/pages/{pageId} to update an existing page or database item

📄 License

• This project is licensed under the MIT License. Please refer to the LICENSE file for details.
• Please read Notion's API documentation and relevant legal terms carefully before use.

⚠️ Important Note

If you want to use sweir1's version, directly clone their repository:

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