Notion

Provides a Notion Model Context Protocol server to search, read, create, and update Notion pages and databases via MCP-enabled clients.

typescript

3

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "sahmadumass-notion-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/your/notion-mcp-server/dist/index.js",
        "--notion-api-key=YOUR_ACTUAL_API_KEY_HERE"
      ],
      "env": {
        "NOTION_API_KEY": "YOUR_ACTUAL_API_KEY_HERE"
      }
    }
  }
}

This MCP server lets you connect Claude and other LLMs to your Notion workspace through a Model Context Protocol interface. You can search Notion, retrieve and create pages, and manage databases and their entries, enabling natural language queries and updates directly from your chat workflows.

How to use

You will run a local MCP server that exposes Notion capabilities to your MCP client. After starting the server, you configure your client to connect to it, then interact with Notion by asking natural language questions such as searching for pages, reading a page, creating or updating content, or managing databases. Claude will handle your requests and invoke the appropriate actions on Notion through the MCP server.

How to install

Prerequisites: Node.js and npm installed on your machine.

Then follow these steps to install and run the server.

# 1) Clone the MCP server project
git clone https://github.com/sahmadumass/notion-mcp-server.git

# 2) Install dependencies
cd notion-mcp-server
npm install

# 3) Build the server
npm run build

# 4) Start the server
npm start

Configure with Claude for Desktop

You will connect Claude for Desktop to the Notion MCP server by adding a stdio configuration that runs the server locally and passes your Notion API key.

Use this example configuration as a template. Replace the path with your actual project location and provide your Notion API key.

{
  "mcpServers": {
    "notion": {
      "command": "node",
      "args": [
        "/path/to/your/notion-mcp-server/dist/index.js",
        "--notion-api-key=YOUR_ACTUAL_API_KEY_HERE"
      ]
    }
  }
}

Available tools

search-notion

Searches the entire Notion workspace for pages, databases, or other content based on your query.

get-page

Retrieves the content of a specific Notion page by its ID.

create-page

Creates a new page in a Notion workspace with specified content and properties.

update-page

Updates the content or title of an existing Notion page.

create-database

Creates a new database within a Notion page with custom properties.

query-database

Queries a Notion database with filters and optional sorting to fetch matching entries.

update-database-entry

Updates properties of a database entry (a page within a database).

create-database-row

Adds a new row to an existing database with specified properties.