notion

This MCP server lets you query and interact with Notion Pages via natural language prompts. After you configure and run the server, you can send prompts that reference Notion Page URLs or IDs, and the server will fetch data from Notion using the integrated token. You can request actions such as reading page content, listing database entries, or creating/updating simple entries on a Notion page, depending on the capabilities exposed by the server. To operate, supply the Notion page link in your prompt and describe the action you want (e.g., read the page, fetch database entries, or add a new entry), and the MCP server will perform the action through the Notion API and return the results. Ensure your Notion integration has the necessary Read/Write permissions for Pages to enable the full range of interactions.

Prerequisites:

• Node.js and npm installed on your machine
• Git installed
• A Notion integration token with appropriate permissions

Step-by-step:

1. Clone the repository git clone https://github.com/arre-ankit/notion-mcp-server.git cd notion-mcp-server

2. Install dependencies npm install

3. Build or prepare the server as required by the project npm run build

4. Run the server (example) node path/to/server.js

5. Configure the Notion integration token in the environment or configuration file as described in the README (NOTION_API_TOKEN).

Tips and caveats:

• Ensure NOTION_API_TOKEN is kept secret and not committed to version control.
• The server relies on a valid Notion integration with appropriate permissions; confirm that the integration is added to the Notion workspace and has Read/Write access for Pages as needed.
• If you encounter rate limit errors from Notion, consider implementing backoff logic or spacing requests.
• When specifying the server path in mcp_config, use the actual entry point file path generated by your build (e.g., dist/index.js) if the project outputs compiled artifacts.
• The example mcp_config uses the node command; if you switch to a packaged build, update the args accordingly.
• Use the Notion Page URL or ID in prompts to target specific pages or databases.