Overleaf Web MCP

Overleaf Web MCP

Permite que Claude, Cursor o cualquier cliente MCP lea, edite, compile y revise tus proyectos de Overleaf, con tu sesión iniciada.

Overleaf Web MCP es un servidor no oficial de Model Context Protocol. Inicia sesión en Overleaf una vez a través de una ventana del navegador que tú controlas, y luego permite que un asistente de IA trabaje en tus proyectos de la misma manera que lo harías en el editor web: explorar archivos, hacer ediciones verificadas por revisión, opcionalmente como cambios rastreados, compilar y gestionar comentarios de revisión. Utiliza los mismos endpoints orientados al navegador que usa el editor de Overleaf, por lo que no se necesita integración con Git ni un plan premium para el flujo de trabajo principal.

Lo que puedes decir

Una vez conectado, habla con tu asistente en lenguaje natural. Él elige las herramientas.

• "Crea un nuevo proyecto llamado Renovación de subvención desde la carpeta que comprimí, y haz que proposal.tex sea la raíz."
• "Lista mis proyectos de Overleaf y abre el que se llama Tesis."
• "Reescribe la introducción de main.tex para una audiencia general, como un cambio rastreado."
• "Compila el artículo y dime si se construyó."
• "¿Qué figuras en ./figures difieren de lo que está en el proyecto? Sube solo esas."
• "Haz que el proyecto coincida con ~/papers/thesis, y muéstrame primero lo que se eliminaría."
• "Resume los comentarios de revisión abiertos y responde al que trata sobre la Tabla 2."

[!CAUTION] Este cliente utiliza las API privadas orientadas al navegador de Overleaf, que Overleaf puede cambiar sin previo aviso. Automatizar www.overleaf.com puede conllevar riesgos para los Términos de Servicio y la cuenta. Comienza con un proyecto desechable y mantén un volumen de solicitudes bajo.

Comenzar

Necesitas Node.js 20 o más reciente, un navegador de la familia Chrome (Chrome, Chromium, Brave o Edge) y una cuenta de Overleaf.

1. Inicia sesión una vez. Se abre una ventana de navegador dedicada. Completa el inicio de sesión normal de Overleaf, incluido SSO o verificación en dos pasos. Solo se guardan las cookies para el origen de Overleaf, en un archivo que solo tu usuario puede leer. La sesión dura cinco días desde su último uso, así que inicia sesión nuevamente después de cinco días de inactividad, o programa npx overleaf-web-mcp keepalive diariamente para mantenerla viva (consulta configuración).

npx overleaf-web-mcp login

2. Conecta tu cliente MCP. Para Claude Code:

claude mcp add overleaf --scope user -- npx -y overleaf-web-mcp serve

Para Claude Desktop, Cursor, VS Code y otros clientes, agrega esto a su configuración MCP:

{
  "mcpServers": {
    "overleaf": {
      "command": "npx",
      "args": ["-y", "overleaf-web-mcp", "serve"]
    }
  }
}

3. Reinicia el cliente y pídele que verifique tu conexión con Overleaf.

Los pasos específicos por cliente, Overleaf autoalojado y solución de problemas, incluido el error "failed to connect" que obtienes cuando node tiene más de 20, están en la guía de instalación.

Lo que puede hacer

• Iniciar y gestionar proyectos. Crear un proyecto en blanco o de ejemplo, clonar uno o importar un zip; renombrar, enviar a la papelera, restaurar o archivar proyectos con el nombre confirmado primero; establecer el documento raíz, el motor TeX y la imagen de TeX Live para que Recompile del editor web lo siga.
• Explorar y organizar. Listar y buscar proyectos, leer el árbol de archivos con el documento raíz y compilador configurados, crear carpetas y archivos, renombrar, mover, subir un archivo o una lista de ellos, descargar un archivo o todo el proyecto como zip, y eliminar con confirmación.
• Sincronizar una carpeta. Comparar una carpeta local con el proyecto sin cambiar nada, luego subir solo lo que cambió y, opcionalmente, eliminar lo que eliminaste localmente, en una sola llamada confirmada. Los archivos de texto modificados pasan por las mismas ediciones verificadas por revisión que una sola escritura, por lo que una edición concurrente de un colaborador nunca se sobrescribe.
• Escribir de forma segura. Reemplazar un documento completo o una sección individual. Cada edición se verifica contra la revisión que leíste primero, por lo que un cambio concurrente de un colaborador se informa en lugar de sobrescribirse. Las ediciones pueden registrarse como cambios rastreados de Overleaf.
• Trabajar por secciones. Analizar los encabezados \section en un archivo, leer una sección, reemplazar una sección.
• Compilar. Construir el documento raíz configurado del proyecto, o cualquier documento que nombres, y detener una compilación en curso.
• Revisar. Listar hilos de comentarios con sus ubicaciones, responder, agregar un comentario anclado a texto exacto y resolver o reabrir hilos.
• Seguir el historial. Consultar el historial reciente del proyecto con un cursor de versión para ver quién cambió qué.

Herramientas

Las 29 herramientas, agrupadas como en la referencia de herramientas, que tiene cada parámetro y resultado. Las herramientas de solo lectura no cambian nada en Overleaf y no escriben nada en tu computadora. Las herramientas destructivas pueden reemplazar o eliminar contenido existente. Todas excepto stop_compile necesitan un valor repetido primero: la ruta, el nombre o el recuento de lo que eliminan, la revisión del documento que reemplazan, el planToken de una sincronización de carpeta o overwrite para un archivo que existe. Hasta 0.6.0, una subida que reemplaza un archivo y una sincronización de carpeta sin un planToken aún se ejecutan sin uno e informan una deprecación; desde 0.6.0 se rechazan. La última columna muestra qué herramientas leen o escriben archivos en la computadora donde se ejecuta el servidor.

Grupo	Herramienta	Qué hace	Anotación	Efecto local
Cuenta	auth_status	Verificar la sesión guardada e informar cuándo expira	solo lectura
Cuenta	list_projects	Listar y buscar proyectos, más recientes primero	solo lectura
Ciclo de vida del proyecto	create_project	Crear un proyecto en blanco o de ejemplo
Ciclo de vida del proyecto	clone_project	Copiar un proyecto, incluidos archivos y configuraciones
Ciclo de vida del proyecto	import_project_zip	Crear un proyecto desde un archivo .zip local		lee
Ciclo de vida del proyecto	manage_project	Renombrar, enviar a la papelera, restaurar, archivar, desarchivar o eliminar un proyecto	destructiva
Ciclo de vida del proyecto	update_project_settings	Establecer el documento raíz, el motor TeX, la imagen de TeX Live o el idioma de revisión ortográfica
Archivos	get_project_tree	Leer el árbol de archivos con la configuración de compilación del proyecto	solo lectura
Archivos	read_file	Leer un documento de texto y su revisión	solo lectura
Archivos	write_file	Reemplazar un documento con una edición mínima verificada por revisión	destructiva	lee
Archivos	create_file	Crear un documento de texto, opcionalmente con contenido
Archivos	manage_entity	Crear una carpeta, o renombrar, mover o eliminar una entidad	destructiva
Archivos	upload_file	Subir un archivo local, reemplazando lo que está en esa ruta cuando se confirma	destructiva	lee
Archivos	batch_upload	Subir una lista de archivos locales a las rutas dadas, creando carpetas faltantes	destructiva	lee
Archivos	download_file	Guardar un documento o archivo binario localmente	destructiva	escribe
Archivos	download_project_zip	Guardar todo el proyecto localmente como un archivo zip	destructiva	escribe
Sincronización de carpeta	plan_sync	Comparar una carpeta local con el proyecto y mostrar lo que haría una sincronización	solo lectura	lee
Sincronización de carpeta	sync_directory	Subir lo que cambió y, en modo espejo, eliminar lo que falta localmente	destructiva	lee
Sincronización de carpeta	delete_entities	Eliminar varios archivos o carpetas en una sola llamada confirmada	destructiva
Secciones	get_sections	Analizar los encabezados de sección de un archivo	solo lectura
Secciones	get_section_content	Leer el cuerpo de una sección	solo lectura
Secciones	write_section	Reemplazar el cuerpo de una sección, verificado por revisión	destructiva
Compilación	compile_project	Compilar el proyecto
Compilación	stop_compile	Detener la compilación activa	destructiva
Revisión	list_comments	Listar hilos de revisión con sus ubicaciones	solo lectura
Revisión	reply_to_comment	Responder en un hilo existente
Revisión	add_comment	Agregar un comentario anclado a texto exacto
Revisión	set_comment_status	Resolver o reabrir un hilo	destructiva
Historial	monitor_project_history	Consultar el historial reciente del proyecto con un cursor	solo lectura

Cómo mantiene tu proyecto seguro

• Las ediciones de texto requieren la revisión de una lectura previa y fallan con un conflicto si el documento cambió debajo.
• Los cambios rastreados son opcionales y nunca se degradan silenciosamente a ediciones simples.
• Eliminar un archivo requiere confirmar su ruta, eliminar varios requiere su recuento, y enviar a la papelera o eliminar un proyecto requiere su nombre. Los proyectos van a la papelera primero; la eliminación permanente solo funciona desde allí. Las descargas, incluido un zip de todo el proyecto, nunca sobrescriben un archivo local a menos que se solicite, y nunca escriben sobre la sesión guardada.
• Una escritura que expira se observa, nunca se reenvía, por lo que nada se aplica dos veces. Lo mismo ocurre con cada archivo en una subida por lotes.
• Dado el planToken de plan_sync, una sincronización de carpeta se detiene antes de cambiar cualquier cosa si el proyecto o la carpeta cambiaron desde el plan. Sin uno no hay nada con qué comparar, lo que 0.6.0 rechazará. Elimina solo en modo espejo, solo con el recuento de eliminación confirmado y nunca después de una subida fallida.
• Opcionalmente, puedes limitar qué proyectos, qué carpetas en tu computadora y qué tipos de cambios puede tocar el servidor (política de acceso). Mantiene a un asistente dentro de lo que le diste; no es un sandbox.
• Tu cookie de sesión permanece en tu máquina en un archivo que solo tú puedes leer y nunca es devuelta por ninguna herramienta.
• Mientras un proyecto está abierto, hasta 90 segundos después de la última llamada, puedes aparecer en línea para los colaboradores.

Cómo se compara

Los tres servidores MCP de Overleaf con más estrellas y los dos más cercanos en diseño a este, cada uno verificado contra su propio código fuente el 2026-09-22. Cambian a menudo, así que sigue los enlaces para su estado actual. ✅ compatible, 🟡 parcialmente (consulta las notas numeradas), ❌ no compatible.

	Este proyecto	OverleafMCP	olcli	overleaf-mcp-server	overleaf-mcp-rt	netique/overleaf-mcp
Se conecta a través de	Sesión web	Puente Git	Sesión web	Puente Git	Sesión web	Sesión web
Herramientas	29	8	19	4	22	17
Funciona sin la integración Git paga de Overleaf	✅	❌	✅	❌	✅	✅
Overleaf autoalojado	✅	❌	✅	🟡¹	✅	🟡²
Listar y buscar tus proyectos	✅	🟡³	🟡⁴	❌	🟡⁵	✅
Devuelve el texto de un documento al asistente	✅	✅	🟡⁶	✅	✅	✅
Envía ediciones como operaciones OT colaborativas, no archivos completos	✅	❌	❌	❌	✅	✅
Rechaza una edición si el documento cambió desde que se leyó	✅	🟡⁷	❌	❌	✅	🟡⁸
Escribe como cambios rastreados cuando se solicita	✅	❌	❌	❌	❌	✅
Acepta o rechaza cambios rastreados	❌	❌	❌	❌	❌	✅
Lee y reemplaza una \section	✅	✅	❌	❌	❌	❌
Crea, renombra, mueve y elimina archivos y carpetas	✅	🟡⁹	🟡¹⁰	🟡⁹	✅	❌
Sube y descarga archivos binarios	✅	❌	✅	❌	✅	🟡¹¹
Compara una carpeta local con el proyecto	✅	❌	✅	❌	❌	❌
Compila en Overleaf	✅	❌	✅	❌	✅	✅
Lee el registro de compilación y errores	❌	❌	❌	❌	✅	✅
Comentarios de revisión: listar, responder, agregar, resolver	✅	❌	✅	❌	✅	🟡¹²
Crea, clona, importa, archiva y elimina proyectos	✅	❌	🟡¹³	❌	❌	❌
Guarda el documento raíz, compilador e imagen de TeX Live	✅	❌	❌	❌	❌	❌
Lee el historial del proyecto	✅	❌	❌	❌	🟡¹⁴	❌
Se instala desde	npm	npm	npm, Homebrew	fuente	npm	npm
Licencia	MIT	MIT	MIT	MIT	AGPL-3.0	AGPL-3.0

1. Solo donde existe el puente Git de Overleaf, que en una instancia autoalojada significa Server Pro.
2. Documentado, pero el inicio de sesión parece requerir la cookie overleaf_session2 de overleaf.com, que Community Edition no establece por defecto.
3. Solo los proyectos nombrados en su propia configuración.
4. Lista proyectos sin búsqueda y omite los archivados y los de la papelera.
5. Lista proyectos, sin búsqueda ni filtro.
6. Los archivos se guardan en el disco del servidor; ninguna herramienta devuelve el texto de un documento.
7. Git rechaza el push si Overleaf avanzó después del pull de la herramienta, pero una edición realizada entre la lectura del asistente y ese pull se sobrescribe.
8. Solo con strict_version: true; por defecto, una edición concurrente se informa después de la escritura.
9. Crea archivos escribiéndolos; sin renombrar, mover ni eliminar.
10. Crea, renombra y elimina archivos y carpetas; sin mover.
11. Descarga archivos binarios; sin subir.
12. Lista, responde, resuelve y reabre hilos, pero no puede añadir un comentario.
13. Crea y renombra proyectos.
14. Informa de lo que los colaboradores cambiaron durante la sesión.

Documentación

Página	Qué cubre
Instalación	Claude Code, Claude Desktop, Cursor, VS Code, Overleaf autoalojado, solución de problemas
Uso	Ejemplos de prompts y qué ocurre internamente
Referencia de herramientas	Las 29 herramientas con parámetros y resultados
Modelo de seguridad	Revisiones, cambios rastreados, confirmaciones, códigos de error
Configuración	Variables de entorno, la política de acceso, proxies, dónde se almacena la sesión y cómo mantenerla activa
Internos	Notas de protocolo, garantías de fiabilidad, proyectos relacionados
Hoja de ruta y Registro de cambios	Hacia dónde va esto y qué ha cambiado

Para agentes de IA

El servidor envía instrucciones de uso al cliente MCP cuando se conecta, y cada descripción de herramienta es autónoma, por lo que un asistente no necesita este README para usarlo correctamente. Los agentes de codificación que contribuyan al repositorio deberían leer AGENTS.md.

Licencia

MIT.