Git 동기화를 통해 Overleaf 프로젝트를 관리하기위한 MCP 서버.

PyPI 패키지 · MCP 레지스트리

이 서버는

• MCP 호환 클라이언트를 Git 동기화를 통해 Overleaf 프로젝트에 연결합니다.
• 목록, 읽기, 쓰기 및 동기화 프로젝트 컨텐츠에 파일 레벨 도구 노출.
• 작업 흐름을 간단하게 유지: 최신 파일을 끌어, 편집, 다음 오버레이프로 다시 밀어.

건축

공구 워크 플로우

요구 사항

• 파이썬 3.13+
• uv 패키지 관리자
• **Git 통합 ** (개인, 그룹, 또는 기관 라이센스)를 가진 Overleaf 계획. 귀하의 기관이 기관에 무료로 액세스 할 수 있는지 확인 - 기관 이메일 사용. 기관이 나열되지 않은 경우, 계획을 업그레이드하십시오.

Git 설치

1.Enable Git - Overleaf → Menu에서 프로젝트를 열 수 있습니다. 2.Copy 프로젝트 ID - 브라우저 URL(예: https://www.overleaf.com/project/69a4f7cc4eaf13bd56de5b04 → 69a4f7cc4eaf13bd56de5b04)에서. 3. **Git 토큰 ** - Account Settings → **Git 통합 인증 토큰 ** → **Generate 새로운 토큰 **. 4. Configure .env - .env.example]을 .env로 복사하고 다음을 기입하십시오:

Overleaf MCP Server

An MCP server for managing Overleaf projects through Git synchronization.

PyPI Package · MCP Registry

What This Server Does

• Connects MCP-compatible clients to your Overleaf project through Git sync.
• Exposes file-level tools to list, read, write, and sync project content.
• Keeps workflow simple: pull latest files, edit, then push back to Overleaf.

Architecture

flowchart LR
  C[MCP Client\nClaude Desktop / other MCP host] -->|Tool Call| S[Overleaf MCP Server]
  S -->|Git Sync| O[Overleaf Git Remote]
  S -->|Read / Write| L[Local Repo Mirror]
  L -->|Commit + Push| O
  O -->|Pull / Fetch| L
  S -->|Tool Result| C

Tool Workflow

sequenceDiagram
  participant Client as MCP Client
  participant Server as Overleaf MCP Server
  participant Local as Local Mirror
  participant Overleaf as Overleaf Git

  Client->>Server: list_files / read_file
  Server->>Local: Ensure local clone
  Server->>Overleaf: git pull
  Overleaf-->>Server: latest content
  Server-->>Client: file list / file content

  Client->>Server: write_file(path, content)
  Server->>Local: update file
  Server->>Local: git commit
  Server->>Overleaf: git push
  Server-->>Client: success + metadata

Requirements

• Python 3.13+
• uv package manager
• An Overleaf plan with Git integration (individual, group, or institution license). Check if your institution provides free access at Overleaf for Institutions - use your institutional email. If your institution is not listed, upgrade your plan.

Git Setup

1. Enable Git - open your project on Overleaf → Menu → enable Git under Integrations.
2. Copy project ID - from the browser URL (e.g. https://www.overleaf.com/project/69a4f7cc4eaf13bd56de5b04 → 69a4f7cc4eaf13bd56de5b04).
3. Generate a Git token - Account Settings → Git integration authentication tokens → Generate new token.
4. Configure .env - copy .env.example to .env and fill in:

OVERLEAF_TOKEN=your_git_token
PROJECT_ID=your_project_id

project_id can also be passed per tool call, but PROJECT_ID is still required by the server configuration.

The Overleaf Git token is account-wide credential material. Store it only in the MCP client’s environment or a protected .env file, and rotate it if it is exposed.

Safety Notes