Notion MCP Server

🚀 Notion MCP Server

Notion MCP Server is a tool based on the Model Context Protocol (MCP) for interacting with the Notion platform. It provides support for operations on pages, blocks, databases, and comments.

🚀 Quick Start

Installation and Configuration

Clone the Repository

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

Install Dependencies

npm install

Set Environment Variables

Create a .env file:

NOTION_TOKEN=your_notion_api_key
NOTION_PAGE_ID=your_notion_page_id

Build the Project

npm run build

Run the Inspector Tool

npm run inspector

Usage Instructions

Introduction

The Notion MCP Server is a tool based on the Model Context Protocol (MCP) for interacting with the Notion platform. It supports operations on pages, blocks, databases, and comments.

Installation

1. Clone the repository.
2. Install dependencies.
3. Set environment variables.
4. Start the server or the inspector tool.

📚 Documentation

Development Guide

Code Structure

• index.ts: The main entry file.
• tools/: Contains tool modules for interacting with the Notion API.
• schemas/: Zod schema files for input and output validation.
• types/: Defines custom types and interfaces.

Development Steps

1. Clone the repository and install dependencies.
2. Modify the code or add new features as needed.
3. Use the inspector tool for debugging and testing.
4. Build the project to generate a production version.

Technical Details

• Building Technology: Uses TypeScript and MCP SDK (version 1.7.0+).
• Dependency Libraries: Integrates the official Notion client library (@notionhq/client, version 2.3.0+).
• Protocol Compliance: Complies with the Model Context Protocol specification.

Troubleshooting

Common Issues

• Authentication Errors: Confirm that the Notion token has the correct permissions and that access to the relevant pages/databases is enabled.
• Page Access Issues: Ensure that the integration is added to the page you want to access.
• Rate Limiting: Optimize requests and use batch operations to improve efficiency.

Contribution Guide

Contributions are welcome! Please follow these steps to submit a Pull Request:

1. Fork the repository.
2. Create a feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes (git commit -m 'Add amazing feature').
4. Push to the branch (git push origin feature/amazing-feature).
5. Submit a Pull Request.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.