Overleaf Web MCP

Overleaf Web MCP

Claude、Codex、Cursor、または任意の MCP クライアントから、あなたとしてサインインした状態で
Overleaf プロジェクトの閲覧、編集、コンパイル、レビューを行えます。

ドキュメント  ·  始める  ·  ツール  ·  安全性  ·  比較  ·  変更履歴

Overleaf Web MCP は、Model Context Protocol サーバーです。あなたが操作するブラウザーウィンドウを通じて Overleaf に一度サインインすると、ウェブエディター上で行うのと同じように、AI アシスタントがプロジェクトを操作できるようになります。ファイルの閲覧、リビジョンを確認したうえでの編集（変更履歴として記録することも可能）、コンパイル、レビューコメントへの対応ができます。Overleaf エディターと同じブラウザー向けエンドポイントを使用するため、基本的なワークフローに Git 連携や有料プランは必要ありません。

できること

接続したら、アシスタントに自然な言葉で話しかけてください。適切なツールを選びます。

• 「フォルダーを圧縮したファイルから Grant renewal という新しいプロジェクトを作成して、proposal.tex をルートファイルにして。」
• 「Overleaf のプロジェクト一覧を表示して、Thesis というプロジェクトを開いて。」
• 「main.tex の序論を一般読者向けに書き直して、変更履歴として記録して。」
• 「論文をコンパイルして、問題なくビルドできたか、エラーがあればその場所も教えて。」
• 「./figures にある画像のうち、プロジェクト内のものと異なるのはどれ？それらだけをアップロードして。」
• 「プロジェクトを ~/papers/thesis と同じ状態にして。まず、削除されるものを見せて。」
• 「未解決のレビューコメントを要約して、Table 2 に関するコメントに返信して。」

はじめに

Node.js 20 以降、Chrome 系ブラウザー（Chrome、Chromium、Brave、または Edge）、および Overleaf アカウントが必要です。

メモ

このサーバーは Overleaf の非公開 Web API を使用しており、予告なく変更される可能性があります。また、www.overleaf.com の自動操作には、利用規約違反やアカウント上のリスクが伴う場合があります。まずは使い捨てのプロジェクトで試し、リクエスト数を抑えてください。

1. 一度サインインします。 専用のブラウザーウィンドウが開きます。SSO や二要素認証を含め、通常どおり Overleaf にログインしてください。保存されるのは Overleaf のオリジンの Cookie のみで、ファイルはユーザー本人だけが読み取れるように保存されます。セッションの有効期間は最終利用から 5 日間です。5 日間利用がなかった場合は再度サインインするか、毎日 npx overleaf-web-mcp keepalive を実行してセッションを維持してください（設定を参照）。

npx overleaf-web-mcp login

2. MCP クライアントを接続します。 Claude Code の場合：

claude mcp add overleaf --scope user -- npx -y overleaf-web-mcp serve

Codex の場合：

codex mcp add overleaf -- npx -y overleaf-web-mcp serve

{
  "mcpServers": {
    "overleaf": {
      "command": "npx",
      "args": ["-y", "overleaf-web-mcp", "serve"]
    }
  }
}

3. クライアントを再起動し、Overleaf への接続を確認するよう依頼してください。

クライアントごとの手順、セルフホスト可能な Overleaf、node が 20 未満の場合に表示される「failed to connect」などのトラブルシューティングについては、インストールガイドをご覧ください。

できること

• プロジェクトの作成と管理。 空のプロジェクトやサンプルプロジェクトの作成、プロジェクトの複製、ZIP のインポートができます。名前を確認してから、プロジェクトの名前変更、ゴミ箱への移動、復元、アーカイブを行えます。また、ルートドキュメント、TeX エンジン、TeX Live イメージを設定し、Web エディターの再コンパイルに反映できます。
• 閲覧と整理。 プロジェクトの一覧表示と検索、設定済みのルートドキュメントおよびコンパイラーを含むファイルツリーの読み取り、フォルダーやファイルの作成、名前変更、移動、1 つまたは複数のファイルのアップロード、ファイルまたはプロジェクト全体の ZIP でのダウンロード、確認後の削除ができます。
• フォルダーの同期。 ローカルフォルダーとプロジェクトを変更せずに比較し、変更された項目だけをアップロードできます。また、ローカルで削除した項目を削除することも、1 回の確認付き呼び出しで行えます。変更されたテキストファイルは、単一の書き込みと同じくリビジョンを確認して編集されるため、共同編集者が同時に行った編集が上書きされることはありません。
• 安全な書き込み。 ドキュメント全体または単一セクションを置き換えられます。各編集は、最初に読み取ったリビジョンと照合されるため、共同編集者による同時変更は上書きされず、変更があったことが報告されます。編集内容を Overleaf の変更履歴に記録することもできます。
• セクション単位での作業。 ファイル内の \section 見出しを解析し、1 つのセクションを読み取って置き換えられます。
• コンパイル。 プロジェクトに設定されたルートドキュメント、または指定した任意のドキュメントをビルドできます。ログから、ファイル名と行番号付きのエラーおよび警告を取得し、ビルドが正常に完了したかどうかも明確に確認できます。ログ全体の読み取り、PDF やその他の出力のローカル保存、実行中のコンパイルの停止も可能です。
• レビュー。 コメントスレッドを位置情報付きで一覧表示し、返信したり、正確なテキストに紐付けてコメントを追加したり、スレッドを解決または再開したりできます。
• 履歴の確認。 バージョンカーソルを使って最近のプロジェクト履歴を取得し、誰が何を変更したかを確認できます。

ツール

8 つのグループ（アカウント、プロジェクトのライフサイクル、ファイル、フォルダーの同期、セクション、コンパイル、レビュー、履歴）に分かれた 31 個のツールがあります。読み取り専用ツールは Overleaf に変更を加えず、コンピューターにも何も書き込みません。破壊的な操作を行うツールは既存のコンテンツを置き換えたり削除したりする場合があり、stop_compile を除くすべてのツールでは、事前に値を受け取り、再確認する必要があります。値には、削除するパス、名前、または件数、置き換えるドキュメントのリビジョン、フォルダー同期の planToken、または既存ファイルに対する overwrite が含まれます。

• テキストを編集するには、事前の読み取り時のリビジョンが必要です。文書がその間に変更されていた場合、競合として失敗します。
• 変更履歴の記録はオプトイン方式で、通常の編集に黙って切り替わることはありません。
• ファイルを削除するにはパスの確認が必要です。複数のファイルを削除するにはファイル数の確認が必要で、プロジェクトをゴミ箱に移動または削除するにはプロジェクト名の確認が必要です。プロジェクトはまずゴミ箱に移動され、完全削除はゴミ箱からのみ実行できます。プロジェクト全体の zip を含むダウンロードで、明示的な指示なしにローカルファイルや保存済みのセッションが上書きされることはありません。
• 書き込みがタイムアウトした場合は結果を確認し、再送信しないため、同じ内容が二重に適用されることはありません。これは一括アップロードの各ファイルにも当てはまります。
• フォルダーの同期には plan_sync の planToken が必要です。計画後にプロジェクトまたはフォルダーが変更されていた場合は、何も変更する前に停止します。削除はミラーモードの場合に限り、削除数の確認が必要で、アップロードが失敗した後に削除することはありません。
• アップロードでファイルが置き換えられることはありません。置き換えを指示した場合を除き、バイナリファイルには overwrite が必要です。また、アップロードによってリビジョン確認なしに置き換えられるテキスト文書には uncheckedDocumentReplace が必要です。
• オプションで、サーバーが操作できるプロジェクト、コンピューター上のフォルダー、変更の種類を制限できます（アクセス ポリシー）。これにより、アシスタントの操作範囲を指定した範囲内に制限できますが、サンドボックスではありません。
• セッション Cookie は、自分だけが読み取れるファイルとしてコンピューター上に保存され、どのツールからも返されることはありません。
• プロジェクトを開いている間は、最後の呼び出しから最大 90 秒間、共同作業者にオンラインとして表示される場合があります。

比較

最もスターが多い Overleaf MCP サーバー3つと、このプロジェクトに設計が最も近い2つについて、2026-09-22にそれぞれのソースコードを確認しました。頻繁に変更されるため、最新の状況はリンク先をご確認ください。✅ 対応、🟡 一部対応（番号付きの注記を参照）、❌ 未対応です。

AI エージェント向け

サーバーは接続時に MCP クライアントへ使い方の説明を送信し、各ツールの説明も単独で完結しているため、アシスタントは正しく使用するうえでこの README を必要としません。このリポジトリに貢献するコーディングエージェントは、AGENTS.md をお読みください。

ライセンス

MIT。Overleaf とは提携も推奨関係もない独立したプロジェクトです。