Notion

by ghubnerr

3 stars

167 downloads

Not rated

GitHub Website

About

Provides a flexible API for querying, searching, creating, updating, and deleting Notion workspaces, enabling developers and knowledge workers to interact with their data through natural language or automated workflows.

Details

Author: ghubnerr
Repository: ghubnerr/Notion-MCP
GitHub stars: 3
Downloads: 167
License: MIT License
Categories: Productivity, Developer Tools, Design, Workplace, AI, Search, Automation, API, Database, Knowledge Base, Other, Project Management

- Lists all databases in the workspace via notion://databases
- Retrieves database schema and content by ID
- Fetches page content and recent workspace updates
- Includes pre-configured prompts: upcoming-deadlines, project-status, daily-tasks
- Supports create, update, delete, and restore operations
- Optional confirmation prompts for destructive actions

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Notion

Command (node, npx, python, etc.) node
Arguments
- Argument 1 /path/to/notion-mcp-server/build/index.js
Environment
- NOTION_API_KEY your_notion_api_key_here
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "notion": {
            "env": {
                "NOTION_API_KEY": "your_notion_api_key_here"
            },
            "args": [
                "/path/to/notion-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "notion": {
            "env": {
                "NOTION_API_KEY": "your_notion_api_key_here"
            },
            "args": [
                "/path/to/notion-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "notion": {
            "env": {
                "NOTION_API_KEY": "your_notion_api_key_here"
            },
            "args": [
                "/path/to/notion-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "notion": {
            "env": {
                "NOTION_API_KEY": "your_notion_api_key_here"
            },
            "args": [
                "/path/to/notion-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "notion": {
            "env": {
                "NOTION_API_KEY": "your_notion_api_key_here"
            },
            "args": [
                "/path/to/notion-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "notion": {
            "env": {
                "NOTION_API_KEY": "your_notion_api_key_here"
            },
            "args": [
                "/path/to/notion-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "notion": {
            "env": {
                "NOTION_API_KEY": "your_notion_api_key_here"
            },
            "args": [
                "/path/to/notion-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "notion": {
            "env": {
                "NOTION_API_KEY": "your_notion_api_key_here"
            },
            "args": [
                "/path/to/notion-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "notion": {
            "env": {
                "NOTION_API_KEY": "your_notion_api_key_here"
            },
            "args": [
                "/path/to/notion-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "notion": {
            "env": {
                "NOTION_API_KEY": "your_notion_api_key_here"
            },
            "args": [
                "/path/to/notion-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "notion": {
            "env": {
                "NOTION_API_KEY": "your_notion_api_key_here"
            },
            "args": [
                "/path/to/notion-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "notion": {
            "env": {
                "NOTION_API_KEY": "your_notion_api_key_here"
            },
            "args": [
                "/path/to/notion-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "notion": {
            "env": {
                "NOTION_API_KEY": "your_notion_api_key_here"
            },
            "args": [
                "/path/to/notion-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "notion": {
            "env": {
                "NOTION_API_KEY": "your_notion_api_key_here"
            },
            "args": [
                "/path/to/notion-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "notion": {
            "env": {
                "NOTION_API_KEY": "your_notion_api_key_here"
            },
            "args": [
                "/path/to/notion-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

From the repository

1. Clone this repository:

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

2. Install dependencies:

   npm install

3. Create a .env file in the root directory with your Notion API key:

```

`upcoming-deadlines`

Get a list of upcoming deadlines.

`project-status`

Summarize the status of a project.

`daily-tasks`

Get a list of tasks for today.

The server provides the following tools:

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "notion": {
            "env": {
                "NOTION_API_KEY": "your_notion_api_key_here"
            },
            "args": [
                "/path/to/notion-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

Linux

{
    "env": {
        "NOTION_API_KEY": "your_notion_api_key_here"
    },
    "args": [
        "/path/to/notion-mcp-server/build/index.js"
    ],
    "command": "node"
}

Macos

{
    "env": {
        "NOTION_API_KEY": "your_notion_api_key_here"
    },
    "args": [
        "/path/to/notion-mcp-server/build/index.js"
    ],
    "command": "node"
}

Windows

{
    "env": {
        "NOTION_API_KEY": "your_notion_api_key_here"
    },
    "args": [
        "/path/to/notion-mcp-server/build/index.js"
    ],
    "command": "node"
}

Notion MCP Server

A Model Context Protocol (MCP) server for integrating with Notion workspaces. This server provides a standardized interface for AI models to access, query, and modify content in Notion.

Prerequisites

- Node.js (v16 or higher)
- Notion API Key (from your Notion integrations)
- Connected Notion workspace with appropriate permissions

Installation

1. Clone this repository:

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

2. Install dependencies:

   npm install

3. Create a .env file in the root directory with your Notion API key:

   # Required
   NOTION_API_KEY=your_notion_api_key_here
# Optional settings

   DEBUG=false

   REQUIRE_CONFIRMATION_FOR_CREATE=true

   REQUIRE_CONFIRMATION_FOR_UPDATE=true

   REQUIRE_CONFIRMATION_FOR_DELETE=true

   UPDATE_POLLING_INTERVAL=60000

   MAX_BLOCK_DEPTH=3

   BACKUP_DIR=./backups

   BACKUP_RETENTION_DAYS=30

   MAX_BACKUPS_PER_PAGE=5

4. Build the project:

   npm run build

5. Start the server:

   npm start

Using with Claude for Desktop

To use this Notion MCP server with Claude for Desktop:

1. Ensure Claude for Desktop is installed and updated to the latest version
2. Open Claude for Desktop's configuration file:

- On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- On Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Add the server configuration:

   {
     "mcpServers": {
       "notion": {
         "command": "node",
         "args": ["/path/to/notion-mcp-server/build/index.js"],
         "env": {
           "NOTION_API_KEY": "your_notion_api_key_here"
         }
       }
     }
   }

4. Save the file and restart Claude for Desktop

Resources

The server exposes the following resources:

| Resource URI | Description |
| ----------------------------------------- | ----------------------------------------------------- |
| notion://databases | Lists all databases in the workspace |
| notion://databases/{databaseId}/schema | Retrieves the schema of a specific database |
| notion://databases/{databaseId}/content | Retrieves all pages/items from a specific database |
| notion://pages/{pageId} | Retrieves the content of a specific page |
| notion://updates | Retrieves recent updates and changes in the workspace |

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

upcoming-deadlines

project-status

daily-tasks

Claude Desktop / Cursor

Linux

Macos

Windows

Notion MCP Server

Prerequisites

Installation

Using with Claude for Desktop

Resources

Install

More like this

Time

Sentry

Github

Git

GitLab

Context 7

`upcoming-deadlines`

`project-status`

`daily-tasks`