MCP Notion Server

What is mcp-notion-server

mcp-notion-server is a Model Context Protocol (MCP) server developed by gabornyergesX to facilitate seamless integration between Claude, an AI system, and Notion, a popular productivity tool. This server acts as a bridge, enabling smooth interaction with Notion's databases and pages. By leveraging this server, users can manage Notion resources, perform CRUD (Create, Read, Update, Delete) operations, and utilize AI-powered prompts for content analysis. Built using TypeScript, mcp-notion-server showcases core MCP concepts by providing secure, real-time access to Notion's data and functionalities.

How to Use mcp-notion-server

To get started with mcp-notion-server, you'll need Node.js version 18 or higher, a Notion API Key, and the Claude Desktop application. Here's a basic setup guide:

1. Create a Notion Integration:

   • Name your integration and set permissions such as "Read content" and "Update content" in Notion. Obtain your "Internal Integration Token" for authentication.

2. Configure Claude Desktop:

   • Add your server configuration to the Claude Desktop configuration file. On MacOS, find this under ~/Library/Application Support/Claude/claude_desktop_config.json, and on Windows, under %APPDATA%/Claude/claude_desktop_config.json.

3. Run mcp-notion-server:

   • Use the command npx -y @gabornyerges/mcp-notion-server to start the server, ensuring your Notion API Key is correctly set in the environment variables.

4. Debugging:

   • For troubleshooting, use the MCP Inspector to monitor server communication, which is available as a package script.

Key Features of mcp-notion-server

mcp-notion-server is packed with features that enhance the functionality of Notion through MCP:

Resources

• Access Management: Seamlessly access Notion pages and databases using URIs.
• Rich Content Support: Handle both plain text and rich text content types.
• Metadata Extraction: Extract metadata from Notion properties for efficient data handling.

Tools

Database Operations

• List Databases: Retrieve a list of all accessible Notion databases.
• Create Database: Set up new databases with custom properties tailored to your needs.
• Query Database: Search and filter entries to find relevant data quickly.
• Update Database: Modify existing database properties and schemas to keep information up-to-date.

Page Operations

• Create Page: Generate new pages within databases or as subpages, complete with titles, properties, and markdown content.
• Update Page: Edit existing page properties to reflect changes.
• Get Page: Access detailed page content and metadata for review or analysis.
• Delete Page: Remove unwanted pages from databases or parent pages.

Block Operations

• Append Blocks: Add new blocks to enhance page content.
• Delete Blocks: Remove unnecessary blocks to streamline information.
• Get Blocks: Retrieve block content for examination.
• Update Blocks: Modify existing block content to maintain accuracy.

Prompts

• Summarize Notes: Generate concise summaries for better understanding and communication.
• Analyze Content: Provide insights and analysis to enhance content value.
• Suggest Tags: Recommend relevant tags based on content to improve organization and retrieval.

With these features, mcp-notion-server offers a powerful solution for integrating AI with Notion, enhancing productivity and data management through intelligent protocols and seamless operations.