Notion MCP Server 7hr

🚀 NOTION-MCP-SERVER

This is an MCP (Multi-Party Collaboration Protocol) server project integrated with Notion. Our goal is to help developers quickly build applications that work in tandem with Notion by providing simple, easy-to-use, and powerful APIs.

🚀 Quick Start

Set up a local MCP server in five minutes:

git clone https://github.com/your-username/notion-mcp-server.git
cd notion-mcp-server
npm install
npm start

✨ Features

• Notion API Support: Fully integrate with the Notion platform via the MCP protocol.
• Easy Deployment and Scalability: Utilize a modern architecture to ensure stable server operation and easy scalability.
• Comprehensive Documentation: Provide complete API documentation and technical guides to help developers get started quickly.

📄 Required Permissions

To ensure the project functions correctly, enable the following permissions in the project settings:

{
  "notion": {
    "read_write": true,
    "discussion_comments": true,
    "database_access": true,
    "user_management": true
  }
}

💻 Usage Examples

Basic Usage (JavaScript)

const { NotionMCPClient } = require('notion-mcp-client');

async function quickStart() {
    const client = new NotionMCPClient({
        token: 'your_notion_integration_token'
    });

    // Create a new page
    const pageId = await client.pages.create({
        title: 'My New Page',
        content: 'This is a test page created via MCP.'
    });

    console.log('Page ID:', pageId);
}

quickStart().catch(console.error);

🤝 Contribution Guidelines

We welcome contributions from the community! If you encounter any issues, please report them on GitHub. We also appreciate feature suggestions and code submissions.

📄 License

This MCP server is licensed under the MIT License, which allows you to freely use, modify, and distribute the software, provided that you retain the copyright notice and license information. For more details, please refer to the LICENSE file in the project repository.

📚 Documentation

Here is a complete list of Notion MCP Server API interfaces:

1. Create a Page

• Method: POST /api/pages/create
• Parameters:
  • title: string
  • content: string
• Return Value: ID of the newly created page

2. Update Page Content

• Method: PUT /api/pages/{pageId}
• Parameters:
  • newContent: string
• Return Value: Status of the update operation

3. Delete a Page

• Method: DELETE /api/pages/{pageId}
• Parameters: None
• Return Value: Status of the deletion operation

4. Query a Database

• Method: GET /api/databases/{dbId}/query
• Parameters:
  • filter: object (optional)
  • sorts: array (optional)
• Return Value: Array of query results

5. Create a New Database

• Method: POST /api/databases
• Parameters:
  • name: string
  • schema: object
• Return Value: ID of the newly created database

6. Get User Information

• Method: GET /api/users/{userId}
• Parameters: None
• Return Value: Object containing detailed user information

7. Create a New User

• Method: POST /api/users
• Parameters:
  • username: string
  • email: string
  • role: string ("user" or "admin")
• Return Value: ID of the newly created user

8. Update User Role

• Method: PUT /api/users/{userId}/role
• Parameters:
  • newRole: string
• Return Value: Status of the update operation

9. Get the Current User

• Method: GET /api/users/current
• Parameters: None
• Return Value: ID and role information of the current user

10. Handle File Upload

• Method: POST /api/files/upload
• Parameters:
  • file: File object
  • description: string (optional)
• Return Value: URL of the uploaded file

For more detailed usage of each API, please refer to our complete developer documentation.