@orbit-logistics/notion-mcp-server

by MCP-Mirror

300 downloads
Not rated
GitHub

About

@orbit-logistics/notion-mcp-server mirrors the entire Notion API SDK as a collection of tools, enabling Large Language Models to interact with Notion seamlessly. It exposes the full Notion API as tools that LLMs can use for reading, creating, updating, and deleting Notion pages…

Details

Author
MCP-Mirror
Downloads
300
Categories
Knowledge Base

- Mirrors the entire Notion API SDK as tools.
- Exposes full Notion API for LLM interaction.
- Supports reading, creating, updating, deleting pages.
- Operates via natural language instructions.
- Integrates with Cursor and Claude Desktop.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name @orbit-logistics/notion-mcp-server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

First create a Notion integration and grant it access to your pages. For Cursor, open Settings > Features > MCP Servers, add a new server, select “command” type, and enter npx -y @orbit-logistics/notion-mcp-server -t <notion_integration_token>. For Claude Desktop, add an entry to claude_desktop_config.json with command npx, args ["-y", "mcp-sequential-thinking-test", "-t", "<notion_integration_token>"].

notion_search_pages

Search trough pages in Notion.

notion_search

Search through Notion with fine-grained control.

notion_retrieve_block

Retrieve a block from Notion.

notion_update_block

Update a block in Notion.

notion_delete_block

Delete a block in Notion.

notion_append_block_children

Append children blocks to a block in Notion.

notion_list_block_children

List all children blocks of a block in Notion.

notion_create_database

Create a new database in Notion.

notion_list_databases

List all databases in Notion (deprecated, use search instead).

notion_query_database

Query a database in Notion.

notion_retrieve_database

Retrieve a database in Notion.

notion_update_database

Update a database in Notion.

notion_create_page

Create a new page in Notion.

notion_retrieve_page

Retrieve a page from Notion

notion_retrieve_page_property

Retrieve a property of a page in Notion.

notion_update_page

Update a page in Notion.

notion_create_comment

Create a new comment in Notion.

notion_list_comments

List all comments for a block in Notion.

notion_list_users

List all users in a Notion workspace.

notion_retrieve_me

Retrieve information about the current bot user.

notion_retrieve_user

Retrieve a user from Notion.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "@orbit-logistics/notion-mcp-server": {
            "orbit-logistics_notion-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@orbit-logistics/notion-mcp-server",
                    "-t",
                    "<notion_integration_token>"
                ]
            }
        }
    }
}

McpServers

{
    "orbit-logistics_notion-mcp-server": {
        "command": "npx",
        "args": [
            "-y",
            "@orbit-logistics/notion-mcp-server",
            "-t",
            "<notion_integration_token>"
        ]
    }
}

@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:

Notion Integration Getting Started

Usage

Using with Cursor

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

1. Open Cursor Settings.
2. Navigate to Features and scroll down to "MCP Servers".
3. Click on "Add new MCP server".
4. Enter a name of your choice and select "command" as the type.
5. 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! Please feel free to open an issue or submit a pull request with your suggestions and improvements.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.