Overleaf for AI agents (olmcp)

[Agent standing over a leaf]

Agent–Overleaf Connector (olmcp)

[tests]

olmcp lets an AI agent respond to review comments in an Overleaf project.

You comment in Overleaf. The agent reads the comment and the selected text, proposes an edit as an Overleaf tracked change, and replies in the same thread. You remain the reviewer: you accept or reject the edit and close the thread.

olmcp has no hosted backend: the connector runs on your computer and uses your Overleaf session. Your chosen AI client may still send MCP results to its model provider under that client's own privacy terms.

The workflow

1. You select text and leave a comment in Overleaf.2. The agent reads the comment and the live project.3. The agent proposes a tracked change and replies in the thread.4. You accept, reject, request another version, or resolve the thread.

By default, an edit is a proposal, not a silent replacement. Overleaf shows the original text as a tracked deletion and the proposed text as a tracked insertion.

Project status: 1.0.0-alpha.3. The core review flow has been used on real Overleaf projects; newer features such as pending-suggestion revision and file creation still need real-service testing. Start with a disposable project.

What the MCP can and cannot do

The tool surface enforces these limits. However, an agent with unrestricted shell access could read the stored session cookie and contact Overleaf outside the MCP. See Security and trust.

Quick start

You need Node.js 20 or newer, an Overleaf account, and an MCP-capable agent such as Claude Code or Codex. You do not need Python, TeX, or Overleaf's paid Git integration. The current GitHub-based installation may also need the git command; normal use does not.

1. Install olmcp

npm install -g github:nipdep/agent-overleaf-connectorolmcp --version

2. Sign in to Overleaf

Copy the overleaf_session2 cookie from your browser's developer tools, then run:

olmcp auth --cookie "<cookie value>"

Treat this cookie like a password. Never paste it into an agent chat, issue, or commit. The setup guide shows where to find it and what to do when it expires.

3. Register the MCP server

Choose your agent, then restart it:

# Claude Codeclaude mcp add --scope user olmcp -- "$(which olmcp)" mcp
# Codexcodex mcp add olmcp -- "$(which olmcp)" mcp

Windows PowerShell commands and other MCP clients are covered in Connect an AI agent.

4. Give the agent your project URL

No project folder or clone is required. After connecting the MCP, paste the Overleaf project URL into the request:

Address the comments in https://www.overleaf.com/project/<project-id>.

If you prefer not to paste the URL each time, you can save the project ID in a working folder with olmcp init. See Choosing a project.

5. Address a comment

In Overleaf, select a sentence and comment “make this clearer.” Then tell your agent:

Address the comments in https://www.overleaf.com/project/<project-id>.

Back in Overleaf, review the tracked edit. Accept or reject it, reply with another request, or resolve the thread yourself.

Everyday controls

Read Using olmcp for examples, modes, tags, file creation, and the complete MCP tool list.

Important safety details

• Tracked changes are attributed to your Overleaf account because the connector uses your session.
• A newly created file cannot be a tracked change. It appears immediately; the connector never overwrites or deletes files.
• #direct changes are immediate. Use Overleaf History if you need to undo one.
• The interface is unofficial and may break when Overleaf changes it.
• The session cookie usually expires after a few days. Run olmcp auth again when olmcp doctor reports an expired session.

Documentation

• Start here: documentation map
• Install and set up
• Use comments, proposals, tags, and files
• Connect and constrain an AI agent
• Run the alpha test checklist
• Check verified behavior and current limits
• Understand the technical design
• Contribute

Release changes are in the changelog. The retired Python workflow—Git sync, source markers, redline.tex, and GitHub Actions—remains on the python-legacy branch.

Logo files: PNG · SVG

License and credit

Apache 2.0. See LICENSE. The Overleaf protocol handling follows the approach used by olcli by Alexander Loth (MIT); see THIRD_PARTY_NOTICES.md.