Overleaf MCP Server

An MCP server that integrates with Overleaf's Git feature, allowing you to manage Overleaf projects directly from your MCP-enabled environment (like Cursor).

Features

• Clone Projects: Clone Overleaf projects to your local machine using the Project ID.

• Pull Changes: Sync latest changes from Overleaf to your local copy.

• Push Changes: Commit and push your local edits back to Overleaf.

• Get Status: Check the status of your local repository (modified files, etc.).

• Authentication Management: Securely configure and store your Overleaf Git credentials.

Installation

1. Clone this repository:

   git clone https://github.com/juho127/overleafMCP.git cd overleafMCP

2. Install dependencies:

   npm install

3. Build the server:

   npm run build

Configuration

Add the server to your MCP settings file (e.g., claude_desktop_config.json or Cursor settings).

Usage

Authentication

Before using the git tools, you should configure your authentication. You can find your Git token in your Overleaf Account Settings.

Tool: configure_auth

• email: Your Overleaf email address.

• token: Your Overleaf Git token (or password).

Cloning a Project

Tool: clone_project

• projectId: The ID from your Overleaf project URL (e.g., 65a1b2c3d4e5f6...).

• localPath: Absolute path where you want to clone the project.

Managing Changes

• Pull: Use pull_changes to get updates from Overleaf.

• Status: Use get_status to see what files you've changed.

• Push: Use push_changes to save your work back to Overleaf.

License

MIT