Enables interaction with Notion workspaces, providing capabilities to search pages, retrieve page content, query databases, and create new pages through the Notion API.
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:
- Install dependencies:
- Create a
.env
file in the root directory with the following content:
- 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:
Or in production mode:
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:
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
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
- AsecurityAlicenseAqualityMCP Server for the Notion API, enabling Claude to interact with Notion workspaces.Last updated -181,299794TypeScriptMIT License
- AsecurityFlicenseAqualityA 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 -107063TypeScript
- -securityAlicense-qualityA 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 -111PythonMIT License
- AsecurityFlicenseAqualityA 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 -12111JavaScript