📌Overview

Purpose: To enable Large Language Models (LLMs) to interact with Notion seamlessly by mirroring the Notion API SDK through a dedicated MCP server.

Overview: The @orbit-logistics/notion-mcp-server leverages the Model Context Protocol (MCP) to expose the full Notion API as intuitive tools for LLMs. This integration facilitates various operations within Notion using natural language commands, providing a powerful way to manage content directly.

Key Features:

Full Notion API Exposure: The MCP server wraps the entire Notion API, enabling LLMs to perform actions like reading, creating, updating, and deleting Notion pages through natural language instructions.
Seamless Integration with Tools: Designed to easily integrate with existing LLM environments like Cursor and Claude Desktop, making deployment straightforward and accessible.

@orbit-logistics/notion-mcp-server

An MCP server that mirrors the entire Notion API SDK as a collection of tools, enabling Large Language Models (LLMs) to interact with Notion seamlessly.

Overview

@orbit-logistics/notion-mcp-server is built on the Model Context Protocol (MCP) and exposes the full Notion API as tools that LLMs can use. This allows for operations such as reading, creating, updating, and deleting Notion pages directly through natural language instructions.

Notion Integration Setup

Before using this server with Cursor or Claude Desktop, you must create a Notion integration and grant it access to your pages. Follow the instructions in the Notion documentation for creating an integration and adding the necessary permissions:

https://developers.notion.com/docs/create-a-notion-integration#getting-started

Usage

Using with Cursor

To integrate @orbit-logistics/notion-mcp-server with Cursor, follow these steps:

Open Cursor Settings.
Navigate to Features and scroll down to "MCP Servers".
Click on "Add new MCP server".
Enter a name of your choice and select "command" as the type.
In the command field, enter the following (replace <notion_integration_token> with your actual token):

npx -y @orbit-logistics/notion-mcp-server -t <notion_integration_token>

This command starts the server with your Notion integration token. Cursor will then use this MCP server to access Notion's API tools.

Using with Claude Desktop

For Claude Desktop, MCP server configurations are stored in a JSON configuration file. Add the following entry to your claude_desktop_config.json (replace <notion_integration_token> with your actual token):

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-sequential-thinking-test",
        "-t",
        "<notion_integration_token>"
      ]
    }
  }
}

This configuration allows Claude Desktop to invoke the notion MCP server for interactions with Notion.

License

This project is licensed under the MIT License.

Contributing

Contributions are welcome! Feel free to open an issue or submit a pull request with suggestions and improvements.