Suekou MCP Notion Server

🚀 Notion MCP Server Guide

The MCP (Multipurpose Control Panel) server is a powerful tool for interacting with the Notion interface. It supports various operations, including creating, reading, updating, and deleting database items, managing users, and handling comments. This article will provide a detailed introduction on how to set up, use, and integrate the MCP server, along with a full Chinese translation.

🚀 Quick Start

1. Create an MCP Instance

Create an MCP server with default configuration:

from mcp_server import MCP

mcp = MCP()

2. Start the Server

Run the following command to start the MCP server:

python mcp_server.py

By default, the server will run on http://localhost:5000.

✨ Features

The following are the main features supported by the MCP server and their detailed descriptions:

1. Create a Page

   • Description: Create a new page in the Notion workspace.
   • Parameters:
     • title: Required, type: string.
     • parent_page_id: Optional, specifies the ID of the parent page.

2. Read Page Content

   • Description: Get the content and properties of a specified page.
   • Parameters:
     • page_id: Required, type: string.

3. Update Page Properties

   • Description: Update the properties or content of an existing page.
   • Parameters:
     • page_id: Required, type: string.
     • properties: Optional, in dictionary format, containing the properties and values to be updated.

4. Delete a Page

   • Description: Delete a specified page from the Notion workspace.
   • Parameters:
     • page_id: Required, type: string.

5. Create a Database Entry

   • Description: Create a new entry in a specified Notion database.
   • Parameters:
     • database_id: Required, type: string.
     • properties: Required, in dictionary format, containing the properties and values of the entry.

6. Read Database Content

   • Description: Get all entries in a specified database.
   • Parameters:
     • database_id: Required, type: string.
     • page_size: Optional, integer, specifies the number of entries per page.

7. Update Database Entry

   • Description: Update the properties or content of an existing database entry.
   • Parameters:
     • database_id: Required, type: string.
     • entry_id: Required, type: string.
     • properties: Optional, in dictionary format, containing the properties and values to be updated.

8. Delete Database Entry

   • Description: Delete a specific entry from a specified database.
   • Parameters:
     • database_id: Required, type: string.
     • entry_id: Required, type: string.

9. Search Content

   • Description: Search for pages, databases, and comments in the Notion workspace.
   • Parameters:
     • query: Optional, string, specifies the search keyword.
     • filter: Optional, in dictionary format, used to limit the search scope (e.g., only pages or databases).

10. Manage Users

    • Description: List all users, get detailed information about a specific user, and create new users.
    • Parameters:
      • user_id: Optional, type: string.
      • username: Optional, type: string.
      • email: Optional, type: string.

11. Handle Comments

    • Description: Create, read, update, and delete comments on a page.
    • Parameters:
      • page_id: Required, type: string.
      • comment_id: Optional, type: string.
      • content: Required, type: string.

📦 Installation

1. Install Dependencies

Before you start, make sure to install the following Python libraries:

• notion: For interacting with the Notion API.
• flask: For creating a web interface (optional).

Run the following command to install them:

pip install notion python-dotenv flask

2. Initialize the Project Structure

Create a new directory and add the following files to it:

• config.py: Stores configuration information, such as the Notion API key and database ID.
• mcp_server.py: The main server file, containing the implementation of the MCP interface.
• requirements.txt: Lists all dependencies.

3. Configure Environment Variables

Add the following content to config.py:

NOTION_TOKEN = "your_notion_token"
DATABASE_ID = "your_database_id"

💻 Usage Examples

Basic Usage

1. Create a New Page

The following is an example code for creating a new page:

mcp.create_page(title="My New Page", parent_page_id="parent_page_id")

2. Update Existing Page Properties

The example code for updating page properties is as follows:

properties = {
    "Status": "Published",
    "Priority": "High"
}
mcp.update_page_properties(page_id="page_id", properties=properties)

3. Search Content

To search for content in the Notion workspace, you can use the following code:

results = mcp.search_content(query="search_term")
for result in results:
    print(result.title, result.type)

🔧 Technical Details

The MCP server provides a detailed error handling mechanism, including validation errors, authorization errors, and network errors. All errors will throw corresponding exceptions with error messages attached.

Example

try:
    mcp.create_page(title="", parent_page_id="parent_id")
except ValueError as e:
    print(e)

📄 License

The MCP server follows the MIT License, which allows you to freely use, modify, and distribute the software. The full license content is as follows:

MIT License

Copyright (c) [Year] [Name]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Contribution Guide

We welcome contributions from the community! If you find any issues or have any improvement ideas, please visit our GitHub repository to submit an Issue or a Pull Request.

How to Contribute

1. Fork the project.
2. Create a new feature branch.
3. Submit your changes.
4. Push to the remote repository and create a Pull Request.

Contact Us

If you have any questions or feedback, please contact our development team:

• Email: contact@notionmcp.com
• GitHub: https://github.com/notionmcp

Thank you for choosing the MCP server! We hope it will bring convenience to your Notion projects.