@microagents/server-notion/README.md

MCP server for Notion API integration

# Notion MCP Server

An MCP server implementation that enables Claude to interact with Notion workspaces through the Notion API.

## Installation

```bash
npm install @microagents/server-notion
# or
yarn add @microagents/server-notion
```

## Usage

### Direct Execution

```bash
# Set your API token and run
NOTION_API_TOKEN=secret_your_token_here npx @microagents/server-notion
```

### With Claude Desktop

Add this to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["@microagents/server-notion"],
      "env": {
        "NOTION_API_TOKEN": "secret_your_token_here"
      }
    }
  }
}
```

## Setup

1. **Create a Notion Integration**:
   * Visit the [Notion Your Integrations](https://www.notion.so/my-integrations) page
   * Click "New Integration"
   * Name your integration and select appropriate permissions (e.g., "Read content", "Update content")

2. **Retrieve the Secret Key**:
   * Copy the "Internal Integration Token" from your integration
   * This token will be used for authentication

3. **Add the Integration to Your Workspace**:
   * Open the page or database you want the integration to access in Notion
   * Click the navigation button in the top right corner
   * Click "Connect to" button and select your integration

## Tools

The server provides 17 tools for interacting with Notion:

### Block Operations
- `notion_append_block_children`: Append child blocks to a parent block
- `notion_retrieve_block`: Retrieve information about a specific block
- `notion_retrieve_block_children`: Retrieve the children of a specific block
- `notion_delete_block`: Delete a specific block

### Page Operations
- `notion_retrieve_page`: Retrieve information about a specific page
- `notion_update_page_properties`: Update properties of a page

### Database Operations
- `notion_create_database`: Create a new database
- `notion_query_database`: Query a database
- `notion_retrieve_database`: Retrieve information about a specific database
- `notion_update_database`: Update information about a database
- `notion_create_database_item`: Create a new item in a Notion database

### Search and User Operations
- `notion_search`: Search pages or databases by title
- `notion_list_all_users`: List all users in the Notion workspace
- `notion_retrieve_user`: Retrieve a specific user by user_id
- `notion_retrieve_bot_user`: Retrieve the bot user associated with the current token

### Comments
- `notion_create_comment`: Create a comment in Notion
- `notion_retrieve_comments`: Retrieve a list of unresolved comments

## License

MIT

## Credits

Based on the original MCP server by [Suekou](https://github.com/suekou/mcp-notion-server).