notion-mcp

joaomj/notion-mcp

3.2

If you are the rightful owner of notion-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A Notion MCP server that is compliant with OpenAI standards.

Notion MCP Server

This project implements a Model Context Protocol (MCP) server that integrates with Notion, allowing external applications (like AI agents) to interact with a user's Notion workspace. It provides a secure way to access and manage Notion content through a standardized API.

Getting Started with Docker Images

The Notion MCP Server components are available as Docker images for easy deployment.

Prerequisites

  • Docker installed on your system.
  • A Notion Integration (Client ID and Client Secret) configured with the correct redirect URI.
  • A GitHub Personal Access Token (PAT) with read:packages scope if pulling from GitHub Container Registry.

Pulling the Images

You can pull the latest Docker images from GitHub Container Registry:

docker pull ghcr.io/joaomj/notion-mcp/auth:latest
docker pull ghcr.io/joaomj/notion-mcp/mcp:latest

Running the Images

To run these images, you will need to configure environment variables for Notion API credentials, an encryption key, and Redis connection details. A docker-compose.yml file is provided in the project repository for simplified local development, which orchestrates both services and a Redis instance.

For detailed instructions on setting up environment variables and running the services, please refer to the docker-compose.yml file and the memory-bank/technical-overview.md document.

For Developers

If you are a developer looking for detailed technical information on the system architecture, data flow, deployment considerations, and how to build and contribute to this project, please refer to the memory-bank/technical-overview.md document.