Notion

🚀 Notion MCP Server

An MCP server for the Notion API that enables Claude to interact and collaborate with Notion workspaces.

🚀 Quick Start

The Notion MCP Server empowers Claude to interact and collaborate with Notion workspaces through the Notion API.

✨ Features

Toolset

1. notion_append_block_children

   • Add child blocks to a parent block.
   • Required Inputs:
     • block_id (string): The ID of the parent block.
     • children (array): An array of child block objects to be added.
   • Return Information: Detailed information about the added blocks.

2. notion_retrieve_block

   • Retrieve information about a specific block.
   • Required Inputs:
     • block_id (string): The ID of the block to retrieve.
   • Return Information: Detailed information about the block.

3. notion_retrieve_block_children

   • Retrieve the child blocks of a specific block.
   • Required Inputs:
     • block_id (string): The ID of the parent block.
   • Optional Inputs:
     • start_cursor (string): The cursor for the next page of results.
     • page_size (number, default: 100, maximum: 100): The number of blocks to retrieve.
   • Return Information: A list of child blocks.

4. notion_delete_block

   • Delete a specific block.
   • Required Inputs:
     • block_id (string): The ID of the block to delete.
   • Return Information: Confirmation of deletion.

5. notion_retrieve_page

   • Retrieve information about a specific page.
   • Required Inputs:
     • page_id (string): The ID of the page to retrieve.
   • Return Information: Detailed information about the page.

6. notion_update_page_properties

   • Update the properties of a page.
   • Required Inputs:
     • page_id (string): The ID of the page to update.
     • properties (object): The properties to update.
   • Return Information: Information about the updated page.

7. notion_create_database

   • Create a new database.
   • Required Inputs:
     • parent (object): The parent object of the database.
     • title (array): The title of the database.
     • properties (object): The properties of the database.
   • Return Information: The ID of the successfully created database.

8. notion_retrieve_databases

   • Retrieve all databases.
   • No required inputs.
   • Return Information: A list of databases.

9. notion_update_database_properties

   • Update the properties of a database.
   • Required Inputs:
     • database_id (string): The ID of the database to update.
     • properties (object): The properties to update.
   • Return Information: Information about the updated database.

10. notion_delete_database

    • Delete a database.
    • Required Inputs:
      • database_id (string): The ID of the database to delete.
    • Return Information: Confirmation of deletion.

11. notion_search

    • Search for content.
    • Required Inputs:
      • query (string): The search keyword.
    • Optional Inputs:
      • page_size (number): The number of results per page.
      • cursor (string): The cursor for pagination.
    • Return Information: Search results.

📦 Installation

Configuration Guide

If you want to use it via Claude Desktop, add the following content to claude_desktop_config.json:

{
  "mcpServers": {
    "notion": {
      "command": "node",
      "args": ["your-built-file-path"],
      "env": {
        "NOTION_API_TOKEN": "your-integration-token"
      }
    }
  }
}

📚 Documentation

Troubleshooting

If you encounter permission errors:

1. Ensure that the integration has the required permissions.
2. Verify that the integration has been added to the relevant pages or databases.
3. Confirm that the token and configuration are correctly set in claude_desktop_config.json.

📄 License

This MCP server is released under the MIT License. This means you are free to use, modify, and distribute the software, but you must comply with the terms and conditions of the MIT License. For more details, please refer to the LICENSE file in the project repository.