Outlook Contacts

mcp-outlook-contacts

Outlook Contacts（Microsoft 365）MCP パック

AI エージェントを1683以上の稼働中のデータソースにつなぐMCPゲートウェイ、Pipeworxの一部です。

ツール

ツール	説明
outlook_list_contacts	Outlook／Microsoft 365のアドレス帳から連絡先を一覧表示します。名前、メールアドレス、電話番号、会社名、役職を含む簡潔な連絡先レコードを返します。連絡先の各項目を対象としたキーワード検索に対応しています。ユーザーがOutlook／Microsoft 365に保存した連絡先を閲覧するために使用します。
outlook_get_contact	IDを指定して、Outlook／Microsoft 365の連絡先1件の詳細を取得します。表示名、すべてのメールアドレス、勤務先と携帯電話の番号、自宅住所、会社名、役職、部署が含まれます。outlook_list_contactsの実行後、アドレス帳から連絡先の詳細を確認するために使用します。
outlook_search_people	サインイン中のOutlook／Microsoft 365ユーザーに特に関連する人物（同僚、頻繁にメールをやり取りする連絡先、所属組織内の人物）を関連度順に検索します。名前、メールアドレス、役職、会社名を含む該当人物を返します。保存済みのアドレス帳に登録されていない場合でも、名前から同僚や頻繁に連絡を取る相手を探すために使用します。
outlook_get_profile	サインイン中のユーザーのMicrosoft 365／Outlookプロフィールを取得します。表示名、メールアドレス、ユーザープリンシパル名が含まれます。どのユーザーの連絡先とアドレス帳が接続されているかを確認するために使用します。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurfなど）に追加します。

{
  "mcpServers": {
    "outlook-contacts": {
      "url": "https://gateway.pipeworx.io/outlook-contacts/mcp"
    }
  }
}

このエンドポイントが実際に提供する内容

https://gateway.pipeworx.io/outlook-contacts/mcpのtools/listは、上の表に記載したツールに加えて、共有Pipeworxメタツールであるask_pipeworx、discover_tools、search_within、remember／recallなど、ゲートウェイ全体で使える一連のツールも返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック独自のツールとともに、共有ツールがおよそ30個表示されます。接続時のinitialize応答に正確な範囲が示されており、その時点での確定情報となります。

これは意図的な仕様であり、偶然に多重化されているわけではありません。メタツールを使うと、このパックの対象外の質問にも対応できます。ask_pipeworxを通じてカタログ全体にルーティングできるため、MCP サーバーをもう1つ追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントに接続するのではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworxのフルゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらのURLも、同じゲートウェイと同じ1683以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworxを使ってすべてのツールにアクセスできます。

MCP クライアントを使わない場合：HTTPで呼び出す

このパックは接続済みのmicrosoftアカウントを使用するため、Pipeworxキーが必要です。https://pipeworx.io/account にサインインしてmicrosoftを接続し、Authorization: Bearer <your Pipeworx key>を指定してPOST https://gateway.pipeworx.io/v1/tools/outlook_list_contactsを呼び出してください。ツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/outlook_list_contactsを呼び出してください。ツールを探すには、{"query":"..."}を指定してPOST https://gateway.pipeworx.io/v1/tools/search_packsを呼び出してください。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルのstdio MCP サーバーとしても動作します。Pipeworxアカウントも、ゲートウェイを経由した通信も必要ありません。

{
  "mcpServers": {
    "outlook-contacts": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-outlook-contacts"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-outlook-contacts

stdin/stdout経由でMCPを使用し、initialize／tools/list／tools/callに応答します。対象はこのパックのツールのみで、上記のゲートウェイ接続で追加される共有メタツールは含まれません。ソースとツールは同じですが、ask_pipeworxによるルーティングはありません。

ask_pipeworxを使う

ツールを直接呼び出す代わりに、自然な英語で質問できます。上記のパックエンドポイントでも、フルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Outlook Contacts data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

More

• Docs and guides
• pipeworx.io

License

MIT