Skip to main content
Glama
Sign In
enesjakozh

Notion MCP Server

by ccabanillas
GitHub
Python
MIT License
95
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Provides a standardized interface for interacting with Notion's API, allowing users to list and query databases, create and update pages, and search across a Notion workspace.

Servidor MCP de Notion

Implementación de servidor del Protocolo de Contexto de Modelo (MCP) para la integración con Notion, que proporciona una interfaz estandarizada para interactuar con la API de Notion. Compatible con Claude Desktop y otros clientes MCP.

Características

  • Listar y consultar bases de datos de Notion
  • Crear y actualizar páginas
  • Buscar en el espacio de trabajo de Notion
  • Obtener detalles de la base de datos y bloquear a los niños
  • Soporte completo de async/await con httpx
  • Tipo seguro con modelos Pydantic v2
  • Manejo adecuado de errores con registro detallado
  • Compatibilidad con MCP 1.6.0

Instalación

  1. Clonar el repositorio:
git clone https://github.com/ccabanillas/notion-mcp.git cd notion-mcp
  1. Cree un entorno virtual e instale dependencias (usando uv):
uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate uv pip install -e .

Alternativamente, utilizando venv estándar:

python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate pip install -e .
  1. Cree un archivo .env en la raíz del proyecto:
NOTION_API_KEY=your_notion_integration_token

Uso

  1. Pruebe el servidor (debería funcionar sin errores):
python -m notion_mcp
  1. Para usarlo con Claude Desktop, ajuste su archivo claude_desktop_config.json (ubicado en ~/Library/Application Support/Claude/claude_desktop_config.json en macOS):
{ "servers": { "notion-mcp": { "command": "/Users/username/Projects/notion-mcp/.venv/bin/python", "args": ["-m", "notion_mcp"], "cwd": "/Users/username/Projects/notion-mcp" } } }

Asegúrese de reemplazar /Users/username/ con la ruta de su directorio de inicio real.

Desarrollo

Estructura del proyecto

notion-mcp/ ├── src/ │ └── notion_mcp/ │ ├── models/ │ │ ├── __init__.py │ │ └── notion.py # Pydantic models for Notion objects │ ├── __init__.py │ ├── __main__.py # Entry point │ ├── client.py # Notion API client │ └── server.py # MCP server implementation ├── .env # Environment variables (add your Notion API key here) ├── .gitignore ├── pyproject.toml # Project dependencies └── README.md

Ejecución de pruebas

pytest

Configuración

El servidor requiere un token de integración de Notion. Para configurarlo:

  1. Vaya a https://www.notion.so/my-integrations
  2. Cree una nueva integración con capacidades adecuadas (lectura/escritura según sea necesario)
  3. Copiar el token de integración
  4. Agreguelo a su archivo .env en el directorio raíz del proyecto:
NOTION_API_KEY=your_notion_integration_token
  1. Comparte tus bases de datos de Notion con la integración (desde el menú "Compartir" de la base de datos)

Contribuyendo

  1. Bifurcar el repositorio
  2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
  3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )
  4. Empujar a la rama ( git push origin feature/amazing-feature )
  5. Abrir una solicitud de extracción

Licencia

Licencia MIT - Úselo bajo su propio riesgo

Solución de problemas

Problemas comunes

  • Errores de conexión : asegúrese de que su clave API de Notion sea correcta y tenga acceso a Internet
  • Errores de permisos : asegúrese de que su integración tenga acceso a las bases de datos a las que intenta acceder
  • Integración de Claude Desktop : si Claude Desktop no se conecta, verifique que su ruta de configuración sea correcta y que el servidor se esté ejecutando sin iniciar sesión en stdout

Expresiones de gratitud

  • Creado para funcionar con Claude Desktop y otros clientes MCP
  • Utiliza la API de Notion (última versión compatible: 22/02/2022)
  • Se mantiene la compatibilidad con MCP 1.6.0
  • Un agradecimiento especial a danhilse , hice referencia a su proyecto notion-mcp-server.

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

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.

Un servidor de protocolo de contexto de modelo que proporciona una interfaz estandarizada para interactuar con la API de Notion, lo que permite a los usuarios enumerar bases de datos, crear páginas y buscar en su espacio de trabajo de Notion.

  1. Características
    1. Instalación
      1. Uso
        1. Desarrollo
          1. Estructura del proyecto
          2. Ejecución de pruebas
        2. Configuración
          1. Contribuyendo
            1. Licencia
              1. Solución de problemas
                1. Problemas comunes
              2. Expresiones de gratitud

                Related Resources

                Related MCP Servers

                • Notion MCP

                  Badhansen
                  -
                  security
                  A
                  license
                  -
                  quality
                  A Model Context Protocol server that integrates with Notion's API to manage personal todo lists, allowing users to view, add, and update tasks directly from Claude.
                  Last updated -
                  3
                  Python
                  MIT License

                • Notion MCP Server

                  SAhmadUmass
                  -
                  security
                  F
                  license
                  -
                  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 -
                  275
                  2
                  TypeScript

                • ConnectWise API Gateway MCP Server

                  jasondsmith72
                  -
                  security
                  F
                  license
                  -
                  quality
                  A Model Context Protocol server that provides a comprehensive interface for interacting with the ConnectWise Manage API, simplifying API discovery, execution, and management for both developers and AI assistants.
                  Last updated -
                  46
                  2
                  Python
                  • Linux
                  • Apple

                • Notion MCP Server

                  emmanuelsystems
                  -
                  security
                  F
                  license
                  -
                  quality
                  A Model Context Protocol server that connects AI assistants like Claude to Notion workspaces, enabling them to view, search, create, and update Notion databases, pages, and content blocks.
                  Last updated -
                  275
                  JavaScript
                  • Apple

                View all related MCP servers

                Appeared in Searches

                ID: 694u8ecn1f