mcpField
M
microsoft365-mcp-server

microsoft365-mcp-server

ローカル
github.com/sapientsai生産性11 日前に更新
リポジトリ

microsoft365-mcp-server について

microsoft365-mcp-serverは、Microsoft 365向けの委任型Microsoft Graphゲートウェイです。一般的なサービスを40種類以上のツールで扱い、関連するアプリ専用サーバーはヘッドレス環境での運用に対応します。

主な機能

  1. 0140種類以上のMicrosoft Graphツール
  2. 02メール、カレンダー、連絡先へのアクセス
  3. 03ファイルとTeamsへのアクセス
  4. 04Planner、OneNote、To Doへのアクセス
  5. 05委任型OAuth認証

活用シーン

  1. 01Microsoft 365のメールや予定表の操作
  2. 02Teamsのファイルや連絡先へのアクセス
  3. 03Graph経由でのPlannerとTo Doの利用

MCP 対応

このプロジェクトはMicrosoft Graph向けのMCPサーバーを提供します。`microsoft365-mcp-server`は委任型のMicrosoft 365操作を公開し、関連する`microsoft-mcp-server`はヘッドレス運用向けのアプリ専用ツールを提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "sapientsai-microsoft365": {
      "command": "npx",
      "args": [
        "-y",
        "microsoft365-mcp-server"
      ],
      "env": {
        "MS365_CLIENT_ID": "<MS365_CLIENT_ID>",
        "MS365_TENANT_ID": "<MS365_TENANT_ID>",
        "MS365_CLIENT_SECRET": "<MS365_CLIENT_SECRET>",
        "MS365_CERT_PATH": "<MS365_CERT_PATH>",
        "MS365_CERT_PASSWORD": "<MS365_CERT_PASSWORD>",
        "MS365_ACCESS_TOKEN": "<MS365_ACCESS_TOKEN>",
        "MS365_AUTH_MODE": "<MS365_AUTH_MODE>",
        "MS365_OAUTH_BASE_URL": "<MS365_OAUTH_BASE_URL>",
        "MS365_READ_ONLY": "<MS365_READ_ONLY>",
        "MS365_ENABLED_TOOLS": "<MS365_ENABLED_TOOLS>",
        "MS365_PRESETS": "<MS365_PRESETS>",
        "MS365_ORG_MODE": "<MS365_ORG_MODE>",
        "TRANSPORT_TYPE": "<TRANSPORT_TYPE>"
      }
    }
  }
}
起動コマンドnpx -y microsoft365-mcp-server
設定が必要な環境変数
MS365_CLIENT_IDAzure AD application (client) ID. Every mode except client-token needs it.
MS365_TENANT_IDAzure AD tenant ID, or 'common'/'organizations'/'consumers'. Read by certificate, client-secret and oauth-proxy modes.
MS365_CLIENT_SECRETシークレットAzure AD client secret (client-secret mode).
MS365_CERT_PATHPath to the certificate used by certificate mode.
MS365_CERT_PASSWORDシークレットPassword for the certificate at MS365_CERT_PATH, if it has one.
MS365_ACCESS_TOKENシークレットA Graph access token supplied directly (client-token mode).
MS365_AUTH_MODEシークレットAuth mode: interactive (default), certificate, client-secret, client-token or oauth-proxy.
MS365_OAUTH_BASE_URLシークレットBase URL of the OAuth proxy (oauth-proxy mode).
MS365_READ_ONLYSet to 'true' to expose read-only tools and refuse every write.
MS365_ENABLED_TOOLSCase-insensitive regular expression matched against tool names; only matching tools are registered. Not a comma-separated list.
MS365_PRESETSComma-separated tool presets to enable instead of naming tools individually.
MS365_ORG_MODESet to 'true' for organisation-wide (application-permission) behaviour.
TRANSPORT_TYPETransport: 'stdio' (the default, and what this npm package is listed as) or 'httpStream' for remote/Docker deployments.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmmicrosoft365-mcp-server1.2.19

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

microsoft365-mcp monorepo

Microsoft Graph MCP サーバー用の pnpm ワークスペースです。アーカイブされた sapientsai/microsoft-mcp-server を起点とし、 共有コアを使用する、目的別に特化した2つのサーバーに分割されています。アプリ専用サーバーは元の microsoft-mcp-server という名前を維持し、委任サーバーは microsoft365-mcp-server です。

パッケージ

  • packages/microsoft365 — microsoft365-mcp-server。委任型の （OAuth プロキシ）MS365 ゲートウェイです。Microsoft Graph を通じて、メール、カレンダー、連絡先、ファイル、Teams、Planner、 OneNote、To Do などに対応する40以上のツールを提供します。 npm に公開されています。詳しくは、 README とモノレポの DEPLOYMENT.md をご覧ください。
  • packages/graph — microsoft-mcp-server（元の名前）。ヘッドレスのドキュメント RAG 向けに特化した、軽量な アプリ専用（client_credentials）サーバーです。 microsoft_graph パススルー、microsoft_graph_batch、read_document、sharepoint_search、 オプションの azure_ai_search、および /upload リレーを備えています。Docker イメージとして ghcr.io/sapientsai/microsoft-mcp-server で提供されています。詳しくはREADMEをご覧ください。
  • packages/core — @sapientsai/ms-graph-core。両サーバーが使用する共通の基盤です（アップロードヘルパー、 チケットトークン、OData／ページネーション、エラーおよび認証ストラテジーの型）。内部ワークスペース用パッケージであり、公開されていません。

認証方式に応じて選択してください。ユーザーが同意操作を行える場合（対話型 OAuth）は packages/microsoft365 を使用します。 テナント全体を対象とするヘッドレスのアプリ専用デプロイには packages/graph を使用してください。

開発

pnpm install
pnpm validate   # format + lint + test + build across all packages
pnpm build      # build all packages
pnpm test       # test all packages

パッケージごとのコマンドは、次の例のようにパッケージのディレクトリ内で実行します。

pnpm --filter microsoft365-mcp-server build
pnpm --filter microsoft-mcp-server dev

履歴

分割の設計背景については、 SAI_PLAN_ms-graph-monorepo_2026-06-20.md をご覧ください。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。