overleaf-mcp-server — Claude Code MCP server: how to install
Connects coding agents to Overleaf projects through Git synchronization. It lets you inspect, update, and commit LaTeX files right from your chat.
claude mcp add overleaf-mcp-server -- uvx overleaf-mcp-integrationWhat overleaf-mcp-server does
The server maintains a local Git mirror of the specified Overleaf workspace. When an agent calls a tool, the server synchronizes the clone, reads contents, and pushes edits back with a fresh commit. Line pagination helps examine lengthy documents in slices.
Running this server requires Python 3.13+ alongside the uv tool. Your Overleaf tier must also include Git integration. Without Git access enabled in your Overleaf account settings, operations fail with a 403 error. Credentials are supplied via OVERLEAF_TOKEN and PROJECT_ID environment variables.
What it helps with
- read and edit Overleaf LaTeX documents directly from an AI agent
- push targeted text replacements to remote papers automatically
- retrieve project directory trees without manual file downloads
- read massive scientific drafts in chunked line ranges
Example prompts for the agent
- List all files in my current Overleaf paper
- Read lines 1 to 80 of
main.texand summarize the methodology - Update the bibliography entry in
references.biband push to Overleaf
How to install overleaf-mcp-server
Platform CLI
claude mcp add overleaf-mcp-server -- uvx overleaf-mcp-integrationuvx runs the command named after the package; if the README names another one, use uvx --from overleaf-mcp-integration <command>
Platform CLI
codex mcp add overleaf-mcp-server -- uvx overleaf-mcp-integrationuvx runs the command named after the package; if the README names another one, use uvx --from overleaf-mcp-integration <command>
Config file
{
"mcpServers": {
"overleaf-mcp-server": {
"command": "uvx",
"args": [
"overleaf-mcp-integration"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from overleaf-mcp-integration <command>
Config file
{
"servers": {
"overleaf-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"overleaf-mcp-integration"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from overleaf-mcp-integration <command>
Platform CLI
gemini mcp add overleaf-mcp-server uvx overleaf-mcp-integrationuvx runs the command named after the package; if the README names another one, use uvx --from overleaf-mcp-integration <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about overleaf-mcp-server
How to install overleaf-mcp-server in Claude Code?
Run claude mcp add overleaf-mcp-server -- uvx overleaf-mcp-integration. You must also export OVERLEAF_TOKEN and PROJECT_ID in your environment.
What does overleaf-mcp-server do?
It bridges your development agent with Overleaf via a local Git mirror, allowing the model to list, inspect, and push edits to documents.
Why does the server return a 403 error?
Overleaf rejects Git actions if your plan lacks Git integration or if the authentication token is invalid. Confirm your account tier and regenerate the token.
