Notion MCP Server

Active Development: Database support is now available! Comments and user management tools have been added. If you find this project useful, please consider giving it a star - it helps me know that this work is valuable to the community and motivates further development.

Table of Contents

• Getting Started & Integration

• Features

• Documentation

• Development

• Technical Details

• Troubleshooting

• Contributing

• License

Getting Started & Integration

Setup Process

1. Obtain a Notion API Key

2. Enable Integration for Your PagesNotion Page Connection

3. Choose Your Integration Method

4. Ask Your AI Assistant to Interact with Notion

Cursor Integration

Method 1: Using mcp.json

1. Create or edit the .cursor/mcp.json file in your project directory:

1. Replace YOUR_KEY and YOUR_PAGE_ID with your actual Notion API key and page ID

2. Restart Cursor to apply the changes

Method 2: Manual Mode

1. Open Cursor and go to Settings

2. Navigate to the "MCP" or "Model Context Protocol" section

3. Click "Add Server" or equivalent

4. Enter the following command in the appropriate field:

1. Replace YOUR_KEY and YOUR_PAGE_ID with your actual Notion API key and page ID

2. Save the settings and restart Cursor if necessary

Claude Desktop Integration

1. Create or edit the mcp.json file in your configuration directory:

1. Replace YOUR_KEY and YOUR_PAGE_ID with your actual Notion API key and page ID

2. Restart Claude Desktop to apply the changes

Features

• ** Notion Integration** - Interact with Notion databases, pages, and blocks

• ** Universal MCP Compatibility** - Works with all MCP clients including Cursor, Claude Desktop, Cline, and Zed

• ** Data Retrieval** - Fetch information from Notion pages, blocks, and databases

• ** Content Creation** - Create and update Notion pages and blocks

• ** Block Management** - Append, update, and delete blocks within Notion pages

• ** Database Operations** - Create, query, and update databases

• ** Batch Operations** - Perform multiple operations in a single request

• ** Archive & Restore** - Archive and restore Notion pages

• ** Search Functionality** - Search Notion pages and databases by title

• ** Comments Management** - Get, create, and reply to comments on pages and discussions

• ** User Management** - Retrieve workspace users and user information

Documentation

Available Tools

`notion_pages`

• Creating new pages with specified content

• Updating page properties

• Archiving pages (moving to trash)

• Restoring previously archived pages

• Searching for pages by title

`notion_blocks`

• Retrieving block content

• Fetching child blocks

• Appending new blocks to a parent

• Updating existing blocks

• Deleting blocks

• Performing batch operations (append, update, delete, mixed)

`notion_database`

• Creating new databases with custom properties

• Querying databases with filters and sorting

• Updating database structure and properties

`notion_comments`

• Retrieving comments from pages and blocks

• Adding new comments to pages

• Replying to existing discussions

`notion_users`

• Listing all workspace users

• Getting details about specific users

• Retrieving information about the current bot user

Available Resources

Development

1. Clone the Repository

2. Install Dependencies

3. Set Up Environment Variables

4. Build the Project

5. Run the Inspector

Technical Details

• Built using TypeScript and the MCP SDK (version 1.7.0+)

• Uses the official Notion API client (@notionhq/client v2.3.0+)

• Follows the Model Context Protocol specification

• Implements tools for CRUD operations on Notion pages, blocks, and databases

• Supports efficient batch operations for performance optimization

• Validates input/output with Zod schemas

Troubleshooting

• Common Issues

• Getting Help

Contributing

1. Fork the repository

2. Create your feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add some amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

License

Notion MCP Server

Active Development: Database support is now available! Comments and user management tools have been added. If you find this project useful, please consider giving it a star - it helps me know that this work is valuable to the community and motivates further development.

Table of Contents

• Getting Started & Integration

• Features

• Documentation

• Development

• Technical Details

• Troubleshooting

• Contributing

• License

Getting Started & Integration

Setup Process

1. Obtain a Notion API Key

2. Enable Integration for Your PagesNotion Page Connection

3. Choose Your Integration Method

4. Ask Your AI Assistant to Interact with Notion

Cursor Integration

Method 1: Using mcp.json

1. Create or edit the .cursor/mcp.json file in your project directory:

1. Replace YOUR_KEY and YOUR_PAGE_ID with your actual Notion API key and page ID

2. Restart Cursor to apply the changes

Method 2: Manual Mode

1. Open Cursor and go to Settings

2. Navigate to the "MCP" or "Model Context Protocol" section

3. Click "Add Server" or equivalent

4. Enter the following command in the appropriate field:

1. Replace YOUR_KEY and YOUR_PAGE_ID with your actual Notion API key and page ID

2. Save the settings and restart Cursor if necessary

Claude Desktop Integration

1. Create or edit the mcp.json file in your configuration directory:

1. Replace YOUR_KEY and YOUR_PAGE_ID with your actual Notion API key and page ID

2. Restart Claude Desktop to apply the changes

Features

• ** Notion Integration** - Interact with Notion databases, pages, and blocks

• ** Universal MCP Compatibility** - Works with all MCP clients including Cursor, Claude Desktop, Cline, and Zed

• ** Data Retrieval** - Fetch information from Notion pages, blocks, and databases

• ** Content Creation** - Create and update Notion pages and blocks

• ** Block Management** - Append, update, and delete blocks within Notion pages

• ** Database Operations** - Create, query, and update databases

• ** Batch Operations** - Perform multiple operations in a single request

• ** Archive & Restore** - Archive and restore Notion pages

• ** Search Functionality** - Search Notion pages and databases by title

• ** Comments Management** - Get, create, and reply to comments on pages and discussions

• ** User Management** - Retrieve workspace users and user information

Documentation

Available Tools

`notion_pages`

• Creating new pages with specified content

• Updating page properties

• Archiving pages (moving to trash)

• Restoring previously archived pages

• Searching for pages by title

`notion_blocks`

• Retrieving block content

• Fetching child blocks

• Appending new blocks to a parent

• Updating existing blocks

• Deleting blocks

• Performing batch operations (append, update, delete, mixed)

`notion_database`

• Creating new databases with custom properties

• Querying databases with filters and sorting

• Updating database structure and properties

`notion_comments`

• Retrieving comments from pages and blocks

• Adding new comments to pages

• Replying to existing discussions

`notion_users`

• Listing all workspace users

• Getting details about specific users

• Retrieving information about the current bot user

Available Resources

Development

1. Clone the Repository

2. Install Dependencies

3. Set Up Environment Variables

4. Build the Project

5. Run the Inspector

Technical Details

• Built using TypeScript and the MCP SDK (version 1.7.0+)

• Uses the official Notion API client (@notionhq/client v2.3.0+)

• Follows the Model Context Protocol specification

• Implements tools for CRUD operations on Notion pages, blocks, and databases

• Supports efficient batch operations for performance optimization

• Validates input/output with Zod schemas

Troubleshooting

• Common Issues

• Getting Help

Contributing

1. Fork the repository

2. Create your feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add some amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

License