NotionMCP Light

NotionMCP Light es un servidor de Protocolo de contexto de modelo (MCP) que utiliza la API de Notion para sincronizar archivos Markdown con páginas de Notion.

descripción general

El proyecto se desarrolló para abordar las ineficiencias de los servidores oficiales del Protocolo de Contexto de Modelo (MCP) de Notion, que leen y escriben Markdown en bloques y consumen tokens LLM. Proporcionamos un servidor MCP no oficial que le permite sincronizar archivos Markdown con páginas/bases de datos de Notion directamente a través de API sin usar tokens.

función

Markdown → Noción
- Reconocer H1 como título de la página
- Cree contenido Markdown como una página de Notion o una página de base de datos
- Se puede especificar el ID de la base de datos
- Usando la API de Notion directamente (sin tokens)
Noción → Markdown
- Convierte una página determinada o una página de una base de datos al formato Markdown.
- Título de salida como H1
- Convertir la estructura de bloques a Markdown
- Guardar en archivo
Compatibilidad con servidores MCP
- Compatible con el Protocolo de Contexto de Modelo (MCP)
- Proporciona puntos finales que se pueden llamar desde herramientas de IA como Cursor y Cline
- Basado en JSON-RPC sobre stdio

instalar

Instalación de dependencias

# uvがインストールされていない場合は先にインストール
# pip install uv

# 依存関係のインストール
uv sync

Configuración del token de API de Notion

Crea una cuenta en Notion Developers y obtén un token API.
Puede configurarlo en una variable de entorno o crear un archivo .env y configurar el token.

# .envファイルの例
NOTION_TOKEN=your_notion_api_token

Cómo utilizar

Iniciar el servidor MCP

Al utilizar UV (recomendado)

uv run python -m src.main

O, si desea especificar el token directamente:

uv run python -m src.main --token your_notion_api_token

Si usas Python normal

python -m src.main

O, si desea especificar el token directamente:

python -m src.main --token your_notion_api_token

Configuración en Cline/Cursor

Para usar NotionMCP Light con herramientas de IA como Cline/Cursor, agregue las siguientes configuraciones a su archivo mcp_settings.json :

"notion-mcp-light": {
  "command": "uv",
  "args": [
    "run",
    "--directory",
    "/path/to/notion-mcp-light",
    "python",
    "-m",
    "src.main"
  ],
  "env": {
    "NOTION_TOKEN": "your_notion_api_token"
  },
  "disabled": false,
  "alwaysAllow": []
}

Reemplace /path/to/notion-mcp-light con el directorio de instalación de NotionMCP Light.

Cómo utilizar las herramientas MCP

NotionMCP Light ofrece las siguientes herramientas MCP:

subirMarkdown

Sube tu archivo Markdown y créalo como una página Notion.

{
  "jsonrpc": "2.0",
  "method": "uploadMarkdown",
  "params": {
    "filepath": "path/to/markdown.md",
    "database_id": "optional_database_id",
    "page_id": "optional_parent_page_id"
  },
  "id": 1
}

Descargar Markdown

Descargue su página de Notion y guárdela como un archivo Markdown.

{
  "jsonrpc": "2.0",
  "method": "downloadMarkdown",
  "params": {
    "page_id": "notion_page_id",
    "output_path": "path/to/output.md"
  },
  "id": 2
}

licencia

Este proyecto se publica bajo la licencia MIT. Consulte el archivo de LICENCIA para obtener más detalles.

This server cannot be installed

security - not tested

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 sincroniza archivos Markdown con páginas de Notion sin utilizar tokens LLM, lo que permite la interacción directa con bases de datos y páginas de Notion a través de llamadas API.

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 -
13
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
Notion MCP Server
ccabanillas
-
security
A
license
-
quality
A 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 -
95
Python
MIT License
markdown-to-html
fashionzzZ
A
security
A
license
A
quality
A Model Context Protocol server that converts Markdown content to HTML format.
Last updated -
1
2,839
3
TypeScript
MIT License

View all related MCP servers

NotionMCP Light

NotionMCP Light

descripción general

función

instalar

Instalación de dependencias

Configuración del token de API de Notion

Cómo utilizar

Iniciar el servidor MCP

Al utilizar UV (recomendado)

Si usas Python normal

Configuración en Cline/Cursor

Cómo utilizar las herramientas MCP

subirMarkdown

Descargar Markdown

licencia

Related MCP Servers

Notion MCP

Notion MCP Server

Notion MCP Server

markdown-to-html

New MCP Servers

MCP directory API