Loading...
MCP server for Notion API, enabling LLMs to interact with Notion workspaces, with Markdown conversion to reduce token usage and optimize efficiency.
Boost this tool
Subscribe to listing upgrades or segmented pushes.
MCP server for Notion API, enabling LLMs to interact with Notion workspaces, with Markdown conversion to reduce token usage and optimize efficiency.
The server allows both read and write operations on Notion workspaces, making it moderately risky. Limiting enabled tools and carefully managing API token security are crucial for safe operation. Markdown conversion, while helpful, may introduce data loss during edits.
Performance depends on the Notion API's responsiveness and the size of the data being transferred. Markdown conversion can improve performance for read operations.
Cost is primarily determined by Notion API usage. Be mindful of API call limits and token consumption, especially when using Markdown conversion.
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "@suekou/mcp-notion-server"],
"env": {
"NOTION_API_TOKEN": "your-integration-token"
}
}
}
}NOTION_API_TOKENnotion_append_block_childrenAppends child blocks to a specified parent block in Notion.
Adds content to existing blocks.
notion_retrieve_blockRetrieves information about a specific block in Notion.
Read-only operation.
notion_retrieve_block_childrenRetrieves the children of a specific block in Notion.
Read-only operation.
notion_delete_blockDeletes a specific block in Notion.
Destructive operation that permanently removes content.
notion_retrieve_pageRetrieves information about a specific page in Notion.
Read-only operation.
notion_update_page_propertiesUpdates properties of a page in Notion.
Modifies page metadata and content.
notion_create_databaseCreates a new database in Notion.
Creates a new database structure.
notion_query_databaseQueries a database in Notion based on specified filters and sorts.
Read-only operation.
notion_retrieve_databaseRetrieves information about a specific database in Notion.
Read-only operation.
notion_update_databaseUpdates information about a database in Notion.
Modifies database metadata and schema.
notion_create_database_itemCreates a new item in a Notion database.
Adds new data entries to a database.
notion_searchSearches pages or databases in Notion by title.
Read-only operation.
notion_list_all_usersLists all users in the Notion workspace.
Read-only operation, requires Enterprise plan.
notion_retrieve_userRetrieves a specific user by user_id in Notion.
Read-only operation, requires Enterprise plan.
notion_retrieve_bot_userRetrieves the bot user associated with the current token in Notion.
Read-only operation.
notion_create_commentCreates a comment in Notion.
Adds comments to pages or blocks.
notion_retrieve_commentsRetrieves a list of unresolved comments from a Notion page or block.
Read-only operation.
API Key
cloud
The server allows both read and write operations on Notion workspaces, making it moderately risky. Limiting enabled tools and carefully managing API token security are crucial for safe operation. Markdown conversion, while helpful, may introduce data loss during edits.
Autonomy depends on the configured tools and permissions. Exercise caution when enabling write and delete operations.
Production Tip
Monitor API usage and error rates to ensure stable operation. Rate limiting may be a concern.
The integration needs permissions for reading and writing content, depending on the tools being used. Ensure the integration is connected to the relevant pages or databases.
Set the `NOTION_MARKDOWN_CONVERSION` environment variable to `true` and use the `format` parameter in your tool calls.
It allows you to restrict the available tools, improving security and reducing the attack surface.
Verify the integration's permissions, ensure it's connected to the relevant pages/databases, and double-check the API token and configuration.
While it reduces token consumption, it may cause issues when editing page content due to the loss of the original structure.
Potentially, but compatibility may vary. Claude Desktop is explicitly supported.
It is not recommended without proper security measures, such as authentication and authorization, as it could expose your Notion workspace to unauthorized access.