Notion MCP Server

MCP Server for the Notion API, enabling Claude to interact with Notion workspaces.

Tools

1. `notion_append_block_children`

2. `notion_retrieve_block`

3. `notion_retrieve_block_children`

4. `notion_delete_block`

5. `notion_retrieve_page`

6. `notion_update_page_properties`

7. `notion_create_database`

8. `notion_query_database`

9. `notion_retrieve_database`

10. `notion_update_database`

11. `notion_create_database_item`

Setup

Here is a detailed explanation of the steps mentioned above in the following articles:

• English Version: https://dev.to/suekou/operating-notion-via-claude-desktop-using-mcp-c0h
• Japanese Version: https://qiita.com/suekou/items/44c864583f5e3e6325d9

1. Create a Notion Integration:

2. Retrieve the Secret Key:

3. Add the Integration to Your Workspace:

4. Configure Claude Desktop:

Add the following to your `claude_desktop_config.json`:

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

Troubleshooting

If you encounter permission errors:

1. Ensure the integration has the required permissions.

2. Verify that the integration is invited to the relevant pages or databases.

3. Confirm the token and configuration are correctly set in `claude_desktop_config.json`.

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.