trackmcp
Back to directory
pashpashpash

mcp-notion-server

View on GitHub
10 stars JavaScriptOthers Updated Jul 28, 2026

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:

bash
git clone https://github.com/pashpashpash/mcp-notion-server.git
   cd mcp-notion-server

2. Install Dependencies:

bash
npm install

3. Build the Project:

bash
npm run build

4. 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:

        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

                                          Run your own MCP server? See who uses it and what to fix.

                                          Measure it with TrackMCP