MCP Notion Server

🚀 Notion MCP Server

This Notion MCP server provides a convenient way to interact with Notion's API, enabling various operations such as page management, database interaction, and user information retrieval.

🚀 Quick Start

📦 Installation

Install Dependencies

Run the following command to install the required dependencies:

pip install python-dotenv requests

Clone the Repository

Use Git to clone this repository:

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

⚙️ Configuration

Get the Configuration File

Create a new file named config.env and add the following content:

NOTION_TOKEN=Your Notion token
PORT=Specified port (default is 5000)

Run the Server

Run the main script to start the MCP server:

python3 mcp_server.py

⚠️ Important Note

• Ensure you have a valid Notion token.
• The PORT in the configuration file can be adjusted as needed.

✨ Features

Basic Features

1. Notion Token Retrieve - Get the currently used Notion token.
2. Port Configuration - Set the port on which the server runs.

Extended Features

3. Page Management - Create, update, and delete pages.
4. Database Interaction - Interact with databases, including creating, querying, and updating items.
5. User Operations - Get user information, including the information of the current bot user.
6. Comment Handling - Create and retrieve comments in Notion pages or blocks.

More Features

Basic Functions

1. Page Management
   • Create new pages.
   • Update existing pages.
   • Delete specified pages.
2. Database Interaction
   • Query database items.
   • Create new database items.
   • Update database items.
   • Delete database items.
3. User Operations
   • Get current user information.
   • Get all user information.
   • Get current bot user information.
4. Comment Handling
   • Create comments in pages or blocks.
   • Query comments on specified pages.
   • Update or delete comments.

Extended Functions

1. Batch Operations
   • Batch create pages or database items.
   • Batch update attributes.
   • Batch delete operations.
2. Advanced Queries
   • Complex condition filtering.
   • Sorting and pagination.
   • Associated queries (e.g., through database relationships).
3. Event Listening
   • Listen for real - time events of page or database changes.
   • Automatically trigger preset operations.
4. Log Recording
   • Record logs of all API calls.
   • Provide detailed error reports.

💻 Usage Examples

Create a Page

POST /api/create_page
Content-Type: application/json

{
  "parent": {
    "database_id": "09d4db7b-xxxx-xxxx-xxxx-c86ab25ef5cf"
  },
  "properties": {
    "Name": {
      "title": [
        {
          "text": {
            "content": "New Page Title"
          }
        }
      ]
    }
  },
  "children": []
}

Update a Page

PUT /api/update_page?id=14f5d08c-xxxx-xxxx-xxxx-d9e6b534a7cd
Content-Type: application/json

{
  "properties": {
    "Name": {
      "title": [
        {
          "text": {
            "content": "Updated Page Title"
          }
        }
      ]
    }
  },
  "children": []
}

Delete a Page

DELETE /api/delete_page?id=14f5d08c-xxxx-xxxx-xxxx-d9e6b534a7cd

Query a Database

POST /api/query_database?database_id=09d4db7b-xxxx-xxxx-xxxx-c86ab25ef5cf
Content-Type: application/json

{
  "filter": {
    "property": "Status",
    "value": {
      "status": {
        "equals": "Completed"
      }
    }
  },
  "sorts": [
    {
      "property": "Creation Time",
      "direction": "descending"
    }
  ],
  "start_cursor": "",
  "page_size": 10
}

Create a Database Item

POST /api/create_database_item?database_id=09d4db7b-xxxx-xxxx-xxxx-c86ab25ef5cf
Content-Type: application/json

{
  "properties": {
    "Name": {
      "title": [
        {
          "text": {
            "content": "New Database Item"
          }
        }
      ]
    },
    "Status": {
      "select": {
        "name": "Completed"
      }
    }
  },
  "children": []
}

Get User Information

GET /api/get_user_info

Create a Comment

POST /api/create_comment
Content-Type: application/json

{
  "parent": {
    "page_id": "14f5d08c-xxxx-xxxx-xxxx-d9e6b534a7cd"
  },
  "properties": {},
  "children": [
    {
      "object": "block",
      "type": "paragraph",
      "paragraph": {
        "rich_text": [
          {
            "type": "text",
            "text": {
              "content": "This is a new comment."
            }
          }
        ]
      }
    }
  ]
}

Get Comments

GET /api/get_comments?page_id=14f5d08c-xxxx-xxxx-xxxx-d9e6b534a7cd

⚠️ Important Note

1. Ensure you have the correct permissions to perform these operations.
2. Comply with Notion's API usage policies and limitations.
3. Regularly check and update the dependency libraries to maintain security and compatibility.

📄 License

This project is licensed under the MIT License. Please refer to the LICENSE file for detailed information.

Thank you for using our MCP server! If you have any questions, please feel free to contact the support team.