@orbit-logistics/notion-mcp-server
LocalAbout @orbit-logistics/notion-mcp-server
@orbit-logistics/notion-mcp-server is an MCP server that maps the Notion API SDK to a set of tools that LLMs can call to read, create, update and delete Notion pages. It suits users who want to manage Notion content through natural language and is released under the MIT License.
Key features
- 01Maps the Notion API SDK to tools
- 02Reads, creates, updates and deletes pages
- 03Accesses Notion with an integration token
- 04Setup guides for Cursor and Claude Desktop
Use cases
- 01Managing Notion pages through chat in Cursor
- 02Reading and writing Notion content from Claude Desktop
MCP support
This is an MCP server that exposes the tools corresponding to the Notion API to MCP clients. Clients launch it with a Notion integration token.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
21Saved tool list · updated 3w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | Yes | |
| notionApiKey | string | Yes |
Details
From the project README@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:
- 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! Please feel free to open an issue or submit a pull request with your suggestions and improvements.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.