# mcp-notion-server

> MCP Server

This repository provides an MCP server enabling Claude to interact with Notion workspaces. It requires setting up a Notion integration, retrieving the API token, and configuring Claude Desktop with the

## Overview

- **Category:** Productivity
- **Language:** TypeScript
- **Stars:** 920
- **Forks:** 61
- **Owner:** suekou
- **GitHub:** https://github.com/suekou/mcp-notion-server
- **Created:** 2024-11-30T10:01:30+00:00
- **Updated:** 2025-03-28T21:41:56+00:00
- **Source:** https://model-context-protocol.com/servers/mcp-claude-notion-integration-server

## Setup

## Setup

1. **Create a Notion Integration**: Visit the [Notion Your Integrations page](https://www.notion.so/profile/integrations), click "New Integration", name it, and select appropriate permissions.
2. **Retrieve the Secret Key**: Copy the "Internal Integration Token" from your integration for authentication.
3. **Add the Integration to Your Workspace**: Open the desired page or database, click the "···" button, then "Connections", and select your integration.
4. **Configure Claude Desktop**: Add the provided configuration snippets to your `claude_desktop_config.json`, ensuring to replace `your-integration-token` with your actual token and adjusting the `args` value based on your setup (either using `npx` or a built file path).

## Tools

## Available Tools

1. `notion_append_block_children` (Append child blocks to a parent block.)
2. `notion_retrieve_block` (Retrieve information about a specific block.)
3. `notion_retrieve_block_children` (Retrieve the children of a specific block.)
4. `notion_delete_block` (Delete a specific block.)
5. `notion_retrieve_page` (Retrieve information about a specific page.)
6. `notion_update_page_properties` (Update properties of a page.)
7. `notion_create_database` (Create a new database.)
8. `notion_query_database` (Query a database.)
9. `notion_retrieve_database` (Retrieve information about a specific database.)
10. `notion_update_database` (Update information about a database.)
11. `notion_create_database_item` (Create a new item in a Notion database.)
12. `notion_search` (Search pages or databases by title.)
13. `notion_list_all_users` (List all users in the Notion workspace.)
14. `notion_retrieve_user` (Retrieve a specific user by user_id in Notion.)
15. `notion_retrieve_bot_user` (Retrieve the bot user associated with the current token in Notion.)
16. `notion_create_comment` (Create a comment in Notion.)
17. `notion_retrieve_comments` (Retrieve a list of unresolved comments from a Notion page or block.)