overleaf-claude-mcp

Conecta Claude con tu cuenta de Overleaf. Claude puede listar tus proyectos, elegir uno, leer el LaTeX y las figuras, editar archivos, compilar y traer el PDF de vuelta.

Overleaf no tiene API pública en el plan gratuito: el puente Git y la sincronización con Dropbox son funciones Premium. Así que este servidor habla los mismos endpoints HTTP y de socket internos que usa la aplicación web de Overleaf, autenticado con una sesión de navegador que creas una sola vez. Cada endpoint se extrajo del propio bundle de JavaScript de Overleaf y luego se probó contra una cuenta real. Consulta Endpoints verificados.

Tutorial

Lo que necesitas

• Node 20 o más reciente (node -v)

• Chrome o Edge instalado

• Una cuenta de Overleaf, el plan gratuito es suficiente

• Claude Code (claude --version) o Claude Desktop

Paso 1: Ejecuta la configuración

Desde esta carpeta, en Windows:

setup.cmd

En macOS o Linux:

./setup.sh

La configuración ejecuta cinco pasos e imprime cada uno:

1. Instala las dependencias

2. Compila a dist/

3. Comprueba si hay una sesión de Overleaf activa. Si no la hay, se abre una ventana del navegador en la página de inicio de sesión de Overleaf

4. Lee uno de tus proyectos reales para demostrar que la conexión funciona

5. Ofrece registrar el servidor con Claude Code

Paso 2: Inicia sesión cuando se abra el navegador

La ventana del navegador es un Chrome real. Inicia sesión como lo harías normalmente, incluida la verificación en dos pasos. Nada escribe tu contraseña por ti y tu contraseña nunca se lee ni se almacena.

Una vez que llegues a tu lista de proyectos, la ventana se cierra sola y la configuración continúa. Las cookies de tu sesión se guardan en ~/.overleaf-claude-mcp/session.json.

Ese archivo equivale a acceso total a tu cuenta de Overleaf. Está en gitignore y se escribe con permisos 0600 en macOS y Linux. En Windows esos bits de permiso se ignoran, así que el archivo es tan privado como tu carpeta de perfil de usuario. No lo compartas y no lo subas al repositorio.

Paso 3: Deja que la configuración registre el servidor

En el paso 5 verás un aviso:

      Register this server with Claude Code now? [y/N]

Responde y. Eso ejecuta:

claude mcp add overleaf -- node C:/CoolYEAH/overleaf-claude-mcp/dist/index.js

Si lo omitiste, o usas un cliente diferente, regístralo manualmente. Para Claude Code, ejecuta el comando anterior. Para Claude Desktop, edita %APPDATA%\Claude\claude_desktop_config.json en Windows o ~/Library/Application Support/Claude/claude_desktop_config.json en macOS:

{
  "mcpServers": {
    "overleaf": {
      "command": "node",
      "args": ["C:/CoolYEAH/overleaf-claude-mcp/dist/index.js"]
    }
  }
}

Paso 4: Reinicia Claude

Los servidores MCP solo se cargan al iniciar. Cierra y vuelve a abrir Claude Code o Claude Desktop.

Confirma que se cargó:

claude mcp list

Deberías ver overleaf listado como conectado. Dentro de una sesión de Claude Code, /mcp muestra lo mismo.

Paso 5: Úsalo

Solo pregunta en lenguaje natural. Claude elige las herramientas por sí mismo.

List my Overleaf projects

Select the Efficient Reasoning project

Read sections/methodology.tex

In sections/results.tex, change "Table 1" to "Table~\ref{tab:main}"

Compile it and tell me what the LaTeX errors are

Show me figures/fig1.png

Save the compiled PDF to C:/tmp/paper.pdf

Elige un proyecto una vez y se mantiene. La selección se guarda en ~/.overleaf-claude-mcp/state.json y sobrevive a los reinicios, así que cada solicitud posterior se aplica a ese proyecto hasta que cambies. Para trabajar en un proyecto diferente en una sola solicitud sin cambiar, nómbralo: "lee main.tex de mi proyecto de tesis".

Related MCP server: claudeleaf

Cómo activarlo

No hay comando de barra ni nada que escribir. Claude lee las descripciones de las herramientas y las llama cuando tu solicitud coincide. Mencionar Overleaf, o un proyecto o archivo que ya hayas seleccionado, es suficiente.

Si Claude no usa las herramientas, las causas habituales son: no reiniciaste después de registrar, o aún no hay ningún proyecto seleccionado. Pregunta "¿qué proyecto de Overleaf está seleccionado?" para comprobarlo.

Herramientas

overleaf_select_project acepta un id de proyecto o cualquier parte de un nombre de proyecto. Si el nombre coincide con más de un proyecto, lista los candidatos en lugar de adivinar. overleaf_delete se niega a ejecutarse a menos que confirm sea true, así que Claude no puede eliminar un archivo por accidente.

Solución de problemas

"No Overleaf session at ..." — aún no has iniciado sesión, o la sesión caducó. Ejecuta npm run login, o setup.cmd de nuevo.

Claude no ve las herramientas — no reiniciaste Claude después de registrar. Comprueba claude mcp list.

Una herramienta falla de repente — Overleaf puede haber cambiado un endpoint. Ejecuta npm run recon, que sondea cada endpoint en modo solo lectura y te dice exactamente qué llamada falló.

Comprueba tu configuración desde la terminal, sin Claude:

npm run read -- "Efficient Reasoning"

Imprime el árbol de archivos y todos los encabezados de sección del proyecto coincidente. Añade una ruta para volcar un solo archivo:

npm run read -- "Efficient Reasoning" sections/methodology.tex

Vuelve a ejecutar la configuración cuando quieras. Reutiliza una sesión activa y vuelve a verificar la conexión, así que también sirve como comprobación de estado.

Cómo funciona

El árbol de archivos proviene de la conexión de socket de Overleaf, porque es la única fuente que incluye los ids de entidad, y los ids son lo que necesitan las escrituras. El protocolo de inicio es GET /socket.io/1/?projectId=<id>, que es el formato de socket.io 0.9; el servidor luego envía joinProjectResponse con todo el proyecto, incluidos rootFolder, ids de documentos y hashes de archivos. El árbol se guarda en caché durante OVERLEAF_TREE_TTL_MS (15s por defecto) y se invalida después de cada escritura.

Los archivos de texto se leen por documento, así que una lectura siempre refleja el estado actual. overleaf_grep lee el archivo del proyecto en su lugar, así que una búsqueda en todo el proyecto cuesta una solicitud en lugar de una por archivo.

Las escrituras pasan por el endpoint de subida. Subir sobre un nombre existente es una actualización in situ: el id de entidad se conserva, así que el historial de Overleaf y cualquier otra persona en el documento siguen funcionando. Las carpetas padre que falten se crean primero.

Endpoints verificados

Confirmados en vivo contra una cuenta real, no asumidos:

:type es doc, file o folder.

Scripts

npm run smoke crea un proyecto llamado claude-mcp-smoketest y luego ejercita escritura, sobrescritura, subida de imágenes, renombrado, movimiento, eliminación y compilación. Deja el proyecto en tu cuenta para que puedas inspeccionarlo. Elimínalo cuando termines.

Configuración

Todo es opcional. Copia .env.example a .env en esta carpeta y se cargará al iniciar.

Limitaciones

Nada de esto es una API compatible, y Overleaf puede cambiarla en cualquier momento. Úsalo con tu propia cuenta. La edición colaborativa en tiempo real no está implementada: las escrituras reemplazan un documento completo en lugar de enviar operaciones a nivel de carácter, así que evita escribir en un archivo mientras otra persona está escribiendo en él.