mcp-notion-server
Documentation
Notion MCP Server
A fork of @suekou's MCP Server for the Notion API, enabling Claude to interact with Notion workspaces.
Setup
1. Clone the Repository:
git clone https://github.com/pashpashpash/mcp-notion-server.git
cd mcp-notion-server2. Install Dependencies:
npm install3. Build the Project:
npm run build4. Create a Notion Integration:
5. Retrieve the Secret Key:
6. Add the Integration to Your Workspace:
7. Configure Claude Desktop:
Add the following to your claude_desktop_config.json:
{
"mcpServers": {
"notion": {
"command": "node",
"args": ["path/to/build/index.js"],
"env": {
"NOTION_API_TOKEN": "your-integration-token"
}
}
}
}Note: Replace "path/to/build/index.js" with the actual path to the built index.js file in your cloned repository.
Troubleshooting
If you encounter permission errors:
1. Ensure the integration has the required permissions.
2. Verify that the integration is invited to the relevant pages or databases.
3. Confirm the token and configuration are correctly set in claude_desktop_config.json.
Tools
1. notion_append_block_children
2. notion_retrieve_block
3. notion_retrieve_block_children
4. notion_delete_block
5. notion_retrieve_page
6. notion_update_page_properties
7. notion_create_database
8. notion_query_database
9. notion_retrieve_database
10. notion_update_database
11. notion_create_database_item
12. notion_search
13. notion_list_all_users
14. notion_retrieve_user
15. notion_retrieve_bot_user
16. notion_create_comment
17. notion_retrieve_comments
License
This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
Frequently asked questions
What is mcp-notion-server?
mcp-notion-server is a Model Context Protocol (MCP) server listed in the TrackMCP directory.
How do I install mcp-notion-server?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is mcp-notion-server open source?
Yes — it is hosted on GitHub at https://github.com/pashpashpash/mcp-notion-server and has 10 stars.
Related MCP tools
A model context protocol server to work with JetBrains IDEs: IntelliJ, PyCharm, WebStorm, etc. Also, works with Android Studio
Web search using free google search (NO API KEYS REQUIRED)
A CLI inspector for the Model Context Protocol
An experiment in software planning using MCP
Adb-mcp is a proof of concept project to enabled AI control of Adobe tools (Adobe Photoshop and Adobe Premiere) by providing an interface to LLMs via the MCP...
The all-in-one Desktop & Docker AI application with built-in RAG, AI agents, No-code agent builder, MCP compatibility, and more.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP