Notion MCP Server

✅ Server is running
🔐 Authentication Required
This API requires an API key for access.

About

This is a Model Context Protocol (MCP) server that provides access to Notion workspaces, allowing you to search, read, create, and update pages and databases.

📧 API Key Access
To request an API key for this service, please contact:
bartosz.dariusz.majewski@gmail.com

API Endpoint

POST requests to: https://codibly-notion.mcp.majewscy.tech/

Available Tools

🔍 Search & Discovery

  • search - Search across your workspace
  • fetch - Get page or database details
  • get_self - Get bot user information
  • get_users - List workspace users
  • get_user - Get specific user details

📄 Pages

  • create_pages - Create new pages
  • update_page - Update page content/properties
  • move_pages - Move pages to new parent
  • duplicate_page - Duplicate existing page

📊 Databases

  • create_database - Create new database
  • update_database - Update database properties

💬 Comments

  • create_comment - Add comment to page
  • get_comments - Get page comments

Example Requests

Search Workspace

curl -X POST https://codibly-notion.mcp.majewscy.tech/ \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: your-api-key-here' \
  -d '{
    "tool": "search",
    "inputs": {
      "query": "project roadmap",
      "query_type": "internal"
    }
  }'

Create Page

curl -X POST https://codibly-notion.mcp.majewscy.tech/ \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: your-api-key-here' \
  -d '{
    "tool": "create_pages",
    "inputs": {
      "pages": [{
        "properties": {"title": "New Page"},
        "content": "# Welcome\nPage content here"
      }]
    }
  }'

Authentication

All API requests must include an X-API-Key header with a valid API key.

Health Check

GET /health - Returns server status (no authentication required)

Notion Integration Setup

To use this MCP with your Notion workspace:

  1. Create a Notion integration at notion.so/my-integrations
  2. Grant the integration access to your workspace pages/databases
  3. Copy the integration token
  4. Add to your local .env file