Overleaf MCP Server

An MCP (Model Context Protocol) server that provides access to Overleaf projects via Git integration. This allows Claude and other MCP clients to read LaTeX files, analyze document structure, extract content, and write files from and to Overleaf projects.

Features

• 📄 File Management: List, read, and write files from and to Overleaf projects
• 📋 Document Structure: Parse LaTeX sections and subsections
• 🔍 Content Extraction: Extract specific sections by title
• 📊 Project Summary: Get overview of project status and structure
• 🏗️ Multi-Project Support: Manage multiple Overleaf projects

Quick Start (recommended)

No clone, no npm install. Add this block to your Claude Desktop config and restart Claude Desktop.

Config file location

OS	Path
Windows	%APPDATA%\Claude\claude_desktop_config.json
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Linux	~/.config/claude/claude_desktop_config.json

macOS / Linux

{
  "mcpServers": {
    "overleaf": {
      "command": "npx",
      "args": ["-y", "@mjyoo2/overleaf-mcp"],
      "env": {
        "OVERLEAF_PROJECT_ID": "YOUR_OVERLEAF_PROJECT_ID",
        "OVERLEAF_GIT_TOKEN": "YOUR_OVERLEAF_GIT_TOKEN"
      }
    }
  }
}

Windows — Claude Desktop on Windows needs cmd /c to find npx:

{
  "mcpServers": {
    "overleaf": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@mjyoo2/overleaf-mcp"],
      "env": {
        "OVERLEAF_PROJECT_ID": "YOUR_OVERLEAF_PROJECT_ID",
        "OVERLEAF_GIT_TOKEN": "YOUR_OVERLEAF_GIT_TOKEN"
      }
    }
  }
}

Restart Claude Desktop. The overleaf tools should appear in the 🔧 menu.

Multi-Project Setup

The env-var Quick Start only handles a single project. For multiple projects, drop a projects.json file into the user config directory and skip the env block in your Claude Desktop config.

File location

OS	Path
Windows	%APPDATA%\overleaf-mcp\projects.json
macOS / Linux	~/.config/overleaf-mcp/projects.json (or $XDG_CONFIG_HOME/overleaf-mcp/projects.json if set)

File contents

{
  "projects": {
    "default": {
      "name": "Main Paper",
      "projectId": "...",
      "gitToken": "olp_..."
    },
    "thesis": {
      "name": "PhD Thesis",
      "projectId": "...",
      "gitToken": "olp_..."
    }
  }
}

Claude Desktop config — same as Quick Start but no env block:

{
  "mcpServers": {
    "overleaf": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@mjyoo2/overleaf-mcp"]
    }
  }
}

(Drop cmd /c on macOS / Linux.)

Reference a specific project in tool calls with projectName:

Use read_file with filePath: "main.tex", projectName: "thesis"

If projectName is omitted, the default entry is used. To put projects.json somewhere other than the standard location, point OVERLEAF_PROJECTS_CONFIG=/absolute/path/projects.json at it from the env block.

Getting Overleaf Credentials

1. Project ID — open your Overleaf project; the ID is in the URL: https://www.overleaf.com/project/[PROJECT_ID]
2. Git Token — Overleaf → Account Settings → Git Integration → "Create Token"

Configuration Reference

The server picks the first matching configuration source: