Notion MCP Server

A simple MCP (Model-Controller-Persistence) server implementation for Notion integration. This server provides a REST API that wraps around the Notion API, making it easier to interact with Notion databases and pages.

Prerequisites

• Node.js (v14 or higher)
• Notion API key (Integration Token)
• Notion database ID

Setup

1. Clone this repository:

   git clone https://github.com/KingGuizzard/notion-mcp.git
   cd notion-mcp
   

2. Install dependencies:

   npm install
   

3. Create a .env file based on the .env.example:

   cp .env.example .env
   

4. Edit the .env file and add your Notion API key and database ID:

   NOTION_API_KEY=your_notion_api_key_here
   NOTION_DATABASE_ID=your_notion_database_id_here
   PORT=3000
   

How to Get a Notion API Key

1. Go to Notion Integrations
2. Click "New integration"
3. Give your integration a name and select the workspace where you want to use it
4. Copy the "Internal Integration Token"

Connecting to a Notion Database

1. Create a new database in Notion or use an existing one
2. Share the database with your integration:
   • Open the database in Notion
   • Click the "..." menu in the top right
   • Click "Add connections"
   • Search for your integration name and select it
3. Copy the database ID from the URL. The database ID is the part of the URL after the workspace name and before the query parameters: https://www.notion.so/workspace/your-database-id?v=...

Starting the Server

Run the following command to start the server:

npm start

The server will start on port 3000 (or the port specified in your .env file).

Available Endpoints

Databases

• GET /api/notion/databases/:databaseId - Query a database
• POST /api/notion/databases/:databaseId/pages - Create a new page in a database

Pages

• GET /api/notion/pages/:pageId - Get a page
• PATCH /api/notion/pages/:pageId - Update a page

Blocks

• GET /api/notion/blocks/:blockId/children - Get block children
• POST /api/notion/blocks/:blockId/children - Add block children
• DELETE /api/notion/blocks/:blockId - Delete a block

Search

• POST /api/notion/search - Search Notion

Example Usage

Query a database

curl -X GET http://localhost:3000/api/notion/databases/your-database-id

Create a new page in a database

curl -X POST http://localhost:3000/api/notion/databases/your-database-id/pages \
  -H "Content-Type: application/json" \
  -d '{
    "properties": {
      "Name": {
        "title": [
          {
            "text": {
              "content": "New task"
            }
          }
        ]
      },
      "Status": {
        "select": {
          "name": "To Do"
        }
      }
    }
  }'

License

MIT