Orbit Logistics Notion MCP Server

A Notion API server based on the MCP protocol that converts the functions of the Notion SDK into a toolset, enabling large language models to directly manipulate Notion content through natural language instructions.

Knowledge management and memory Note-taking tools #Notion integration #MCP protocol #LLM tools Remote .TypeScript

rating : 2 points

downloads : 14

update time : 2025-04-28

What is Notion MCP Server?

This is a middleware service based on the Model Context Protocol (MCP) that converts the official Notion API into an AI toolset. Through this service, AI assistants like Cursor/Claude can directly read, create, or modify your Notion content as easily as having a conversation with a person.

How to use Notion MCP Server?

Simply configure the server address and your Notion key in the AI tool, and the AI will automatically gain full Notion operation capabilities. You can directly issue natural language instructions like 'Help me add a new entry to the travel plan database'.

Use cases

Suitable for knowledge workers who need to frequently update Notion content, team collaboration scenarios, and users who want to manage Notion content through voice/chat.

Main features

Full API supportSupports all functions of the official Notion SDK, including CRUD operations on pages/databases, rich text editing, attribute modification, etc.

Natural language interactionThe AI automatically converts your natural language instructions into API calls without the need to memorize complex commands.

Cross-platform supportCompatible with mainstream AI development environments such as Cursor/Claude. You can use it across multiple platforms after one-time configuration.

Advantages and limitations

Advantages

Operate Notion content without coding

Fast real-time synchronization response

Retain the original permission system of Notion

Limitations

Need to pre-authorize Notion integration

Complex queries require clear instructions

The free version has a limit on the number of API calls

How to use

Create a Notion integration

Create a new integration on the Notion developer platform and note down the displayed key (starting with secret_).

Configure the AI tool

Add the MCP server in the settings of Cursor/Claude and fill in the following startup command (replace YOUR_TOKEN).

Authorize page access

On the top right of the Notion page you need to operate, invite your integration through the... menu.

Usage examples

Create meeting minutesAutomatically generate formatted meeting records in the specified database

Intelligent queryRetrieve database content in a natural language way

Frequently Asked Questions

Why can't the AI access my Notion page?

What should I do if the error 'Invalid token' appears when starting the service?

Which Notion block types are supported?

Related resources

Notion official API documentation

Complete API reference and examples

GitHub repository

Project source code and issue tracking

MCP protocol description

Understand the underlying communication protocol

🚀 @orbit-logistics/notion-mcp-server

A server based on the MCP protocol that fully replicates the functionality of the Notion API SDK, enabling large language models (LLMs) to seamlessly interact with Notion.

📋 Overview

@orbit-logistics/notion-mcp-server is based on the Model Context Protocol (MCP) and exposes its full Notion API functionality as a tool. This allows LLMs to perform 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 first create a Notion integration and grant it access to your pages. Please follow the instructions in the Notion documentation:

Get started with creating a Notion integration

💻 Usage Instructions

🚀 Using with Cursor

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

Open Cursor settings.
Navigate to features and scroll down to the "MCP Server" section.
Click "Add new MCP Server".
Enter a name of your choice and set the type to "Command".
Enter the following in the command box (replace <notion_integration_token> with your actual token):

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

This command starts the server and uses your Notion integration token. Cursor will call the Notion API tool through this MCP server.

🚀 Using with Claude Desktop

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

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