MCP Server Notion

🚀 Notion MCP Server

A Model Context Protocol (MCP) server implementation for seamless integration between Claude AI and Notion workspaces, supporting read and write functions.

📋 Project Overview

This project aims to build an MCP server that connects Claude AI with Notion workspaces, enabling Claude to:

• Read content from Notion databases and pages
• Update existing content
• Search across the entire Notion workspace
• Query and filter database entries
• Retrieve detailed page content and database schemas

🛠️ Prerequisites

• Node.js (v16+)
• Notion API key
• Claude Desktop

🚀 Quick Start

1. Set up Notion API access

1. Create a Notion integration at https://www.notion.so/my-integrations.
2. Name your integration (e.g., “Claude MCP Integration”).
3. Set the integration type to “Internal”.
4. Copy your API key.
5. Share your Notion pages and databases by clicking the “...” menu in the top - right corner of any page/database and selecting “Add connection”.

2. Install dependencies

npm install

3. Configure environment variables

Create a .env file in the project root directory containing your Notion API key:

NOTION_API_KEY=your_api_key_here

This step is only required if you are developing the server.

4. Build

Build the server for use by Claude.

npm run build

If you are developing the server, you can run npm run dev or npm run inspect.

5. Add to Claude Desktop configuration

Open claude_desktop_config.json (navigate to Settings > Developer and click Edit Config), and add the following:

"notion": {
  "command": "node",
  "args": [
    "path/to/mcp-server-notion/dist/index.js"
  ],
  "env": {
    "NOTION_API_KEY": "your_notion_api_key_here"
  }
}

6. Restart Claude

After restarting Claude, you're ready to go!

✨ Features

This MCP server provides the following tools:

• search_notion: Search across the entire Notion workspace using a query string.
• get_notion_page: Retrieve detailed content of a specific Notion page.
• get_notion_database: Get the metadata and schema of a Notion database.
• query_notion_database: Support complex queries to search and filter entries in a Notion database.

📚 Resources and References

• Official Notion API documentation
• Model Context Protocol specification
• Example MCP server implementation
• Claude developer documentation

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is released under the MIT License. See the LICENSE file for details.