Skip to main content
Glama
enesjakozh

Notion MCP Server

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

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

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

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 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
                  238
                  3

                • Notion MCP Server

                  emmanuelsystems
                  A
                  security
                  F
                  license
                  A
                  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 -
                  12
                  238
                  1
                  • Apple

                • Notion MCP Server

                  ghubnerr
                  -
                  security
                  A
                  license
                  -
                  quality
                  A Model Context Protocol server that provides a standardized interface for AI models to access, query, and modify content in Notion workspaces.
                  Last updated -
                  238
                  4
                  MIT License
                  • Apple

                • NotionMCP Light

                  karaage0703
                  -
                  security
                  A
                  license
                  -
                  quality
                  A Model Context Protocol server that synchronizes Markdown files with Notion pages without using LLM tokens, enabling direct interaction with Notion databases and pages through API calls.
                  Last updated -
                  48
                  MIT License

                View all related MCP servers

                Appeared in Searches

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/ccabanillas/notion-mcp'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server