Notion MCP Server

by suekou

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
NOTION_API_TOKENYesYour Notion API integration token
NOTION_MARKDOWN_CONVERSIONNoSet to 'true' to enable experimental Markdown conversion. This can significantly reduce token consumption when viewing content, but may cause issues when trying to edit page content.false

Schema

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Tools

Functions exposed to the LLM to take actions

NameDescription
notion_append_block_children

Append new children blocks to a specified parent block in Notion. Requires insert content capabilities. You can optionally specify the 'after' parameter to append after a certain block.

notion_retrieve_block

Retrieve a block from Notion

notion_retrieve_block_children

Retrieve the children of a block

notion_delete_block

Delete a block in Notion

notion_update_block

Update the content of a block in Notion based on its type. The update replaces the entire value for a given field.

notion_retrieve_page

Retrieve a page from Notion

notion_update_page_properties

Update properties of a page or an item in a Notion database

notion_list_all_users

List all users in the Notion workspace. Note: This function requires upgrading to the Notion Enterprise plan and using an Organization API key to avoid permission errors.

notion_retrieve_user

Retrieve a specific user by user_id in Notion. Note: This function requires upgrading to the Notion Enterprise plan and using an Organization API key to avoid permission errors.

notion_retrieve_bot_user

Retrieve the bot user associated with the current token in Notion

notion_create_database

Create a database in Notion

notion_query_database

Query a database in Notion

notion_retrieve_database

Retrieve a database in Notion

notion_update_database

Update a database in Notion

notion_create_database_item

Create a new item (page) in a Notion database

notion_create_comment

Create a comment in Notion. This requires the integration to have 'insert comment' capabilities. You can either specify a page parent or a discussion_id, but not both.

notion_retrieve_comments

Retrieve a list of unresolved comments from a Notion page or block. Requires the integration to have 'read comment' capabilities.

notion_search

Search pages or databases by title in Notion

ID: fmpvbhdv37