Notion MCP Client

by phoenine

API/Clients & Integration Notion API Claude Automation

A Model Context Protocol (MCP) client for interacting with the Notion API. It's designed for modern AI tools like Claude that support MCP for extended functionality.

View on GitHub

Last updated: N/A

What is Notion MCP Client?

The Notion MCP Client is a tool that allows you to interact with the Notion API using the Model Context Protocol (MCP), as well as standard HTTP requests. It provides an asynchronous API, concurrency control, and flexible configuration options.

How to use Notion MCP Client?

First, install the client using pip. Configure your Notion API credentials in a .env file. You can then use the command-line interface, start the server for MCP or HTTP API access, or integrate the NotionRequestHandler class into other frameworks. When using with Claude, configure Claude to use the server endpoint.

Key features of Notion MCP Client

Asynchronous API operations with retry logic
Concurrency control to respect Notion API rate limits
Environment-based configuration
JSON-based operation configuration
Flexible server implementation with MCP support
Fall back to standard HTTP API when MCP is not available

Use cases of Notion MCP Client

Automating Notion database updates
Integrating Notion with AI tools like Claude
Building custom workflows with Notion data
Programmatically managing Notion pages
Filling web URL fields in Notion pages

FAQ from Notion MCP Client

What is MCP?

Model Context Protocol (MCP) is a protocol that allows AI models to interact with external services.

How do I install the client?

Use pip install notion-mcp or install from source. For MCP support, use pip install notion-mcp[mcp].

How do I configure the client?

Create a .env file with your Notion API credentials and other configuration options.

How do I start the server?

Run notion-mcp-server --host 0.0.0.0 --port 8000.

What operations are available?

Currently, the fill_web_url operation is available, with more operations coming soon.