README.md•1.89 kB
# 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:
```bash
git clone https://github.com/juho127/overleafMCP.git
cd overleafMCP
```
2. Install dependencies:
```bash
npm install
```
"args": ["/path/to/overleafMCP/build/index.js"]
}
}
}
```
### Other Clients (e.g., Cursor)
For other MCP-supported clients like Cursor:
1. Go to **Settings** > **Features** > **MCP Servers**.
2. Click **+ Add New**.
3. Enter the command to run the server:
- Command: `node`
- Args: `/absolute/path/to/overleafMCP/build/index.js` (Replace with your actual path)
## 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