MCP Office Excel

MCP Office

Microsoft Office 向けのローカルファーストで、ガバナンスの効いた MCP サーバーです。Office ファイルをコードと同じように扱いたい開発者のために構築されています。

---

これは何ですか？

MCP Office は、Microsoft Office の機能を、ガバナンスの効いた決定論的なツール呼び出しとして公開する Model Context Protocol サーバーのスイートです。各サーバーは Windows 上でローカルに動作し、お使いの MCP クライアント（Claude Desktop、VS Code Copilot、または MCP 互換のクライアント）に接続して、アプリ内 AI アシスタントを使わずに Office ファイルを構造化して操作できます。

これは Copilot の代替ではありません。 Office オートメーションのための、開発者を第一に考えた実行レイヤーです。

---

パッケージ

✅ 現在利用可能

パッケージ	機能	インストール	ツール
excelmcp	Excel ブックの読み取り、書き込み、スタイル設定、検証、エクスポート	pip install mcp-office	65
pptmcp	PowerPoint プレゼンテーションの作成、編集、レビュー、エクスポート。機械検証可能なスライド仕様のための Output Contract フレームワーク	pip install mcp-office	51
wordmcp	Word 文書のテンプレート組み立て、変更履歴のサポート、構造的な品質保証	pip install mcp-office	50

🚧 次回追加予定

パッケージ	ステータス
mailmcp	現在のソース配布物に統合済み。Windows Outlook の UAT と公開済み成果物の検証は保留中

MailMCP は、リポジトリの単一の mcp-office ソース配布物に含まれるようになりましたが、現在公開されている PyPI 成果物では、MailMCP の利用可能性はまだ保証されていません。Windows Outlook の UAT とリリース検証が完了するまでは、ソースの検証について mailmcp/README.md を参照してください。

新しいパッケージは、実証サイクルを完了するたびに追加されます。ROADMAP.md をご覧ください。

---

クイックスタート

前提条件

• Windows 10 または 11
• Python 3.11 以降（python --version）
• Claude Desktop または GitHub Copilot を備えた VS Code
• Microsoft Office（Excel／PowerPoint／Word） — COM を利用するツール（スタイル設定、PDF エクスポート、変更履歴）に必要
• Microsoft Outlook クラシック デスクトップ版 — MailMCP に必要

インストール

PyPI に関する注意： PyPI の excelmcp は無関係なサードパーティ製パッケージです。pip install excelmcp は実行しないでください。他人のコードをインストールすることになります。公開されているスイートパッケージは mcp-office です。

pip install mcp-office

または、ソースからスイートをクローンしてインストールします（MailMCP と Windows COM サポートを含みます）。

git clone https://github.com/dosev-ai/mcp-office.git
cd mcp-office
python -m venv .venv
.venv\Scripts\activate
python -m pip install -e ".[com]"

Claude Desktop の設定

%APPDATA%\Claude\claude_desktop_config.json を開き（存在しない場合は作成し）、インストールしたサーバーを追加します。

{
  "mcpServers": {
    "excel-excelmcp": {
      "command": "python",
      "args": ["-m", "excelmcp.server"],
      "env": {
        "EXCEL_ALLOWLIST_ROOTS": "C:\\path\\to\\your\\files",
        "EXCEL_ENABLE_WRITE": "true"
      }
    },
    "powerpoint-pptmcp": {
      "command": "python",
      "args": ["-m", "pptmcp.server"],
      "env": {
        "PPT_ALLOWLIST_ROOTS": "C:\\path\\to\\your\\files",
        "PPT_ENABLE_WRITE": "true"
      }
    },
    "word-wordmcp": {
      "command": "python",
      "args": ["-m", "wordmcp.server"],
      "env": {
        "WORD_ALLOWLIST_ROOTS": "C:\\path\\to\\your\\files",
        "WORD_ENABLE_WRITE": "true"
      }
    }
  }
}

C:\\path\\to\\your\\files を、Office ファイルが保存されているディレクトリに置き換えてください。保存後、Claude Desktop を再起動します。

動作確認

Claude Desktop で、次のメッセージを送信します。

Call capabilities() on excel-excelmcp
Call capabilities() on powerpoint-pptmcp
Call capabilities() on word-wordmcp

それぞれツール一覧が返されます（Excel は 65、PowerPoint は 51、Word は 50）。サーバーが見つからない場合は、python が mcp-office をインストールした仮想環境を参照していることを確認してください。

パッケージ別の完全ガイド：excelmcp/README.md · pptmcp/README.md · wordmcp/README.md · mailmcp/README.md (ソースに統合済み。リリース待ち)

詳しい手順：docs/quickstart.md

---

要件

要件	備考
Windows 10 または 11	COM オートメーションには Windows が必要です
Python 3.11+	python --version で確認してください
Microsoft Office	COM に依存するツール（スタイル設定、PDF エクスポート、変更履歴）に必要です。読み取り専用の docx／xlsx／pptx ツールは Office がなくても動作します。
クラシック版 Outlook デスクトップ	MailMCP に必要です。Windows Outlook UAT と公開済みアーティファクトの検証に合格するまで、MailMCP はリリース保留中です。
MCP クライアント	Claude Desktop または Copilot 搭載の VS Code

---

アーキテクチャ

Your MCP client (Claude Desktop / VS Code Copilot / other)
        │
        │  MCP stdio protocol
        ↓
  MCP Office servers (local Python processes)
   ├─ excelmcp    — Excel automation (live)
   ├─ pptmcp      — PowerPoint automation (live)
   ├─ wordmcp     — Word automation (live)
   └─ mailmcp     — Outlook automation (source-integrated; release pending)
        │
        │  COM / Outlook COM / openpyxl / python-pptx / python-docx
        ↓
  Microsoft Office (local installation)

各サーバーは、独立して動作するローカルの stdio MCP プロセスです。MCP Office はホスト型サービスを追加しません。ただし、Microsoft Office およびお使いの MCP クライアント／モデルには、独自の同期やデータ取り扱いの境界が存在する場合があります。

---

貢献

このプロジェクトは現在、活発に開発されています。現時点での貢献方法としておすすめなのは、次のとおりです。

1. いずれかのパッケージ（excelmcp、pptmcp、wordmcp）を試して、初回実行レポートを作成する
2. GitHub Issuesからバグを報告する
3. GitHub Discussionsで質問する、または作成したものを共有する

開発ガイドラインについては、CONTRIBUTING.mdをご覧ください。

---

ライセンス

MIT — LICENSEをご覧ください。