Notion MCP Server

A server that connects to the Notion API and exposes functionality through Claude's Machine Context Protocol (MCP).

Features

Search Notion pages by title or content
Retrieve page details and content
Query Notion databases
Create new pages in Notion

Setup

Clone this repository:

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

Install dependencies:

npm install

Create a .env file in the root directory with the following content:

NOTION_API_KEY=your_notion_api_key_here
PORT=3000
# Optional: if you want to query a specific database by default
NOTION_DATABASE_ID=your_notion_database_id_here

Get your Notion API key:
- Go to https://www.notion.so/my-integrations
- Create a new integration
- Copy the "Internal Integration Token"
- Add this token as your NOTION_API_KEY in the .env file
Connect your Notion integration to your workspace:
- Go to a page or database in your Notion workspace
- Click the "..." menu in the top right
- Select "Add connections"
- Find and add your integration

Running the Server

Start the server in development mode:

npm run dev

Or in production mode:

npm start

The server will run on the port specified in your .env file (default: 3000).

API Endpoints

Regular HTTP Endpoints

POST /api/notion/search
- Search for pages in Notion
- Body: { "query": "search term" }
POST /api/notion/page
- Get a page by ID
- Body: { "page_id": "page-id-here" }
POST /api/notion/database/query
- Query a database
- Body: { "database_id": "database-id-here", "filter": {}, "sorts": [] }
POST /api/notion/page/create
- Create a new page
- Body: { "parent": {}, "properties": {}, "children": [] }

MCP Integration

The server exposes an MCP manifest at /mcp/manifest.json which describes the available functions.

To invoke an MCP function, send a POST request to /api/notion/mcp/invoke with the following structure:

{
  "function_name": "search_pages",
  "parameters": {
    "query": "search term"
  }
}

Available MCP Functions

search_pages - Search Notion pages by title or content
get_page - Get a Notion page by ID
query_database - Query a Notion database
create_page - Create a new page in Notion

License

MIT

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A server that connects to the Notion API and exposes functionality through Claude's Machine Context Protocol, enabling search, retrieval, querying, and creation of Notion pages and databases.

Related MCP Servers

Notion MCP Server
suekou
A
security
A
license
A
quality
MCP Server for the Notion API, enabling Claude to interact with Notion workspaces.
Last updated -
18
1,299
794
TypeScript
MIT License
Notion MCP Server
SAhmadUmass
A
security
F
license
A
quality
A Model Context Protocol server that enables Claude and other LLMs to interact with Notion workspaces, providing capabilities like searching, retrieving, creating and updating pages, as well as managing databases.
Last updated -
10
706
3
TypeScript
Notion MCP Server
ccabanillas
-
security
A
license
-
quality
A Model Context Protocol server that provides a standardized interface for interacting with Notion's API, enabling users to list databases, create pages, and search across their Notion workspace.
Last updated -
111
Python
MIT License
Notion MCP Server
Sjotie
A
security
F
license
A
quality
A Model Context Protocol server that connects Claude and other AI assistants to your Notion workspace, allowing AIs to interact with databases, pages, and blocks.
Last updated -
12
1
11
JavaScript

View all related MCP servers

Notion MCP Server