Notion MCP Server

This repository contains the MCP Server for the Notion API, designed to enable Claude to interact with Notion workspaces. It provides a bridge between Claude and Notion, allowing for automated tasks and data retrieval.

Setup:

The setup involves creating a Notion integration, retrieving the internal integration token, and adding the integration to your desired workspace. You then configure Claude Desktop by adding the server details to the claude_desktop_config.json file, specifying the command to run the server and setting the NOTION_API_TOKEN environment variable.

Environment Variables:

• NOTION_API_TOKEN: Your Notion API integration token.
• NOTION_MARKDOWN_CONVERSION: Enables experimental Markdown conversion for reduced token consumption.

Tools:

The server provides a suite of tools for interacting with Notion, including:

• notion_append_block_children: Appends child blocks to a parent block.
• notion_retrieve_block: Retrieves information about a specific block.
• notion_retrieve_block_children: Retrieves the children of a specific block.
• notion_delete_block: Deletes a specific block.
• notion_retrieve_page: Retrieves information about a specific page.
• notion_update_page_properties: Updates properties of a page.
• notion_create_database: Creates a new database.
• notion_query_database: Queries a database.
• notion_retrieve_database: Retrieves information about a specific database.
• notion_update_database: Updates information about a database.
• notion_create_database_item: Creates a new item in a Notion database.
• notion_search: Searches pages or databases by title.
• notion_list_all_users: Lists all users in the Notion workspace.
• notion_retrieve_user: Retrieves a specific user by user_id in Notion.
• notion_retrieve_bot_user: Retrieves the bot user associated with the current token in Notion.
• notion_create_comment: Creates a comment in Notion.
• notion_retrieve_comments: Retrieves a list of unresolved comments from a Notion page or block.

Each tool supports an optional format parameter to control the response format (JSON or Markdown).

License:

This MCP server is licensed under the MIT License.