Skip to main content
Glama

ms-365-mcp-server

build status license

Microsoft 365 MCP 서버

Microsoft 365 및 Microsoft Office 서비스와 Graph API를 통해 상호작용하기 위한 MCP(Model Context Protocol) 서버입니다.

참고: 이것은 A-Impact의 내부 빌드이며 npm에 공개되어 있지 않습니다. 아래의 npx @a-impact/ms365-mcp 명령은 해당 스코프로 패키지를 직접 게시한 경우에만 적용됩니다. 이 저장소에서 바로 실행하려면 npm install && npm run build를 사용하고 MCP 클라이언트가 dist/index.js를 가리키게 하십시오. 자세한 내용은 로컬 개발을 참조하세요.

지원되는 클라우드

이 서버는 여러 Microsoft 클라우드 환경을 지원합니다:

클라우드

설명

인증 엔드포인트

Graph API 엔드포인트

글로벌 (기본)

국제 Microsoft 365

login.microsoftonline.com

graph.microsoft.com

중국 (21Vianet)

21Vianet이 운영하는 Microsoft 365

login.chinacloudapi.cn

microsoftgraph.chinacloudapi.cn

Related MCP server: Microsoft Graph MCP

전제 조건

  • Node.js >= 20 (권장)

  • Node.js 14+ 이상은 의존성 경고와 함께 작동할 수 있습니다.

주요 기능

  • Microsoft 인증 라이브러리(MSAL)를 통한 인증

  • 포괄적인 Microsoft 365 서비스 통합

  • 안전한 작업을 위한 읽기 전용 모드 지원

  • 세부적인 접근 제어를 위한 도구 필터링

  • 도구 프리셋 및 동적 도구 검색으로 도구 노출 영역과 토큰 사용량 축소

출력 형식: JSON 대 TOON

이 서버는 전역적으로 구성할 수 있는 두 가지 출력 형식을 지원합니다:

JSON 형식 (기본값)

보기 좋게 출력되는 표준 JSON 형식:

{
  "value": [
    {
      "id": "1",
      "displayName": "Alice Johnson",
      "mail": "alice@example.com",
      "jobTitle": "Software Engineer"
    }
  ]
}

(실험적) TOON 형식

효율적인 LLM 토큰 사용을 위한 Token-Oriented Object Notation:

value[1]{id,displayName,mail,jobTitle}:
  "1",Alice Johnson,alice@example.com,Software Engineer

장점:

  • JSON보다 토큰을 30~60% 절약

  • 균일한 배열 데이터(이메일 목록, 일정 이벤트, 파일 등)에 가장 적합

  • 대규모 및 비용에 민감한 애플리케이션에 이상적

사용 방법: (실험적) TOON 형식을 전역으로 활성화:

CLI 플래그 사용:

npx @a-impact/ms365-mcp --toon

Claude Desktop 구성 파일에서:

{
  "mcpServers": {
    "ms365": {
      "command": "npx",
      "args": ["-y", "@a-impact/ms365-mcp", "--toon"]
    }
  }
}

환경 변수 사용:

MS365_MCP_OUTPUT_FORMAT=toon npx @a-impact/ms365-mcp

지원되는 서비스 및 도구

이 서버는 Microsoft Graph API 대부분을 포괄하는 300개 이상의 도구를 제공합니다. 각 도구는 Graph API 엔드포인트와 1:1로 매핑되며, src/endpoints.json에서 선언적으로 정의됩니다.

개인 계정 도구 (기본 제공)

이메일(Outlook), 일정(Calendar), OneDrive 파일, Excel, OneNote, 할 일(To Do Tasks), Planner, 연락처, 사용자 프로필, 검색

조직 계정 도구 (--org-mode 플래그 필요)

Teams 및 채팅, 온라인 회의, 기록 및 녹화(Transcripts & Recordings), 출석 보고서, SharePoint 사이트 및 목록, 공유 사서함 및 일정, 사용자 관리, 현재 상태, 가상 이벤트

Graph API의 인증 권한

권한은 활성화된 도구에 따라 동적으로 요청됩니다. --list-permissions를 사용하면 귀하의 구성에 필요한 정확한 권한을 확인할 수 있습니다:

# Personal mode (default)
npx @a-impact/ms365-mcp --list-permissions

# Organization mode (includes Teams, SharePoint, etc.)
npx @a-impact/ms365-mcp --org-mode --list-permissions

# Filtered by preset
npx @a-impact/ms365-mcp --preset mail --list-permissions

이 기능은 Graph API 권한이 새 버전을 배포하기 전에 사전 승인되고 관리자 동의를 받아야 하는 엔터프라이즈 환경에 유용합니다.

--st-permissions JSON에는 다음이 포함됩니다:

  • toolPermissions: --allowed-scopes 필터링 전에 도구 surface에서다음에 필요한 권한

  • effectivePermissions: --allowed-scopes 이후에도 남아 활성화된 도구가 암시하는 권한

  • permissions: 기존 스크립트와의 호환성을 위해 유지되는 effectivePermissions용 기존 별칭

  • allowedScopes: 구성된 사용 범위 허용 목록 (제공된 경우)

  • disabledTools: 필요한 Graph 범위가 allowedScopes로 적용되지 않아 숨겨진 도구

  • missingAllowedScopesForTools: 비활성화된 도구에서 누락된 고유 범위

  • extraAllowedScopesNotUsedByTools: 현재 도구가 abs 사용하지 않는 허용 범위

허용 범위

기본적으로 MSAL은 활성화된 도구가 필요로 하는 범위를 요청하며, 도구 구성은 --enabled-tools, --preset, --org-mode 및 --read-only에 의해 제어됩니다.

엔터프라이즈 및 무인(unattended) 배포는 --allowed-scopes 또는 MS365_MCP_ALLOWED_SCOPES로 범위 지정을 할 수 있습니다. 구성된 경우 서버는 먼저 일반 도구 노출 영역을 계산한 다음, 기본 범위가 허용 목록에 포함되지 않는 Graph 도구를 숨깁니다. OAuth 메타데이터와 로그인 흐름은 활성 상태로남은 도구들의 유효 권한만 요청합니다.

npx @a-impact/ms365-mcp \
  --org-mode \
  --enabled-tools '^(list-mail-messages|get-mail-message|list-drives|get-drive-item|download-bytes)$' \
  --allowed-scopes 'User.Read Mail.Read Files.Read'

CLI 값이 MS365_MCP_ALLOWED_SCOPES보다 우선합니다. 둘 다 설정하지 않으면 기본 동작인 도구 파생 범위가 그대로 유지됩니다. 빈 값을 제공하면 시작시 실패하여 배포가 실수로 더 넓은 도구 영역으로 전환하는 일이 없습니다.

범위 적용은 계층 구조를 인식합니다. 예를 들어 Mail.ReadWrite는 Mail.Read를 요구하는 도구를 포함하고, Files.ReadWrite.All는 Files.Read를 요구하는 도구를 포함합니다.

SharePoint는 두 가지 엔터프라이즈 권한 모델을 지원합니다:

  • 테넌트 전체 범위 (예: Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All).

  • Microsoft Graph Sites.Selected와 같은 범위는 특정 사이트 모음에서 앱에 SharePoint 사이트 액세스 권한을 부여하고, Graph는 요청 시 사용자 자신의 권한을 평가합니다.

기본 조직 모드 동작은 기존 배포에서 사용해 온 광범위 포괄 SharePoint 범위를 계속 요청합니다. 선택한 사이트 SharePoint 액세스를 원하는 엔터프라이즈는 광범위한 Sites.*.All 범위 대신 Sites.Selected를 포함한 허용 목록을 설정할 수 있습니다. 명확한 SharePoint 사이트를 대상으로 하는 직접 사이트/목록/항목 도구는 Sites.Selected로도 실행할 수 있으며, 테넌트 전체 SharePoint 검색 및 검색 도구에는 여전히 광범위한 SharePoint 범위가 필요합니다.

npx @a-impact/ms365-mcp \
  --org-mode \
  --read-only \
  --enabled-tools 'sharepoint|site|drive|planner' \
  --allowed-scopes 'User.Read Files.Read Notes.Read Tasks.Read Sites.Selected'

HTTP 모드에서는 OAuth 검색이 유효한 필터링된 권한을 광범위하게 알려 클라이언트가 동일한 동의 범위를 요청하도록 합니다. On-Behalf-Of 모드(--obo)는 보호된 리소스 메타데이터에 api://<clientId>/access_as_user를 계속 광고합니다. --allowed-scopes는 OBO를 무시하지 않습니다.

추가 범위 요청

--allowed-scopes는 항상 토큰 요청을 좁힙니다(narrows). 번들 도구가 필요로 하지 않는 Graph 범위를 요청하려면(예: graph-batch로 엔드포인트를 구동하는 경우) --extra-scopes(또는 MS365_MCP_EXTRA_SCOPES)을 사용합니다. 이 범위는 도구에서 파생된 범위 위에 토큰 요청에 원본 그대로 추가됩니다.

npx @a-impact/ms365-mcp \
  --org-mode \
  --extra-scopes 'CopilotPackages.ReadWrite.All'

이 옵션은 사용자의 Azure 앱 등록(MS365_MCP_CLIENT_ID / MS365_MCP_CLIENT_SECRET)과 함께 사용하도록 설계되었습니다. 기본 업스트림 앱은 소량의 고정 권한 집합만 선언하므로, 추가 범위는 사용자가 제어하는 앱에 대해 요청하십시오(테넌트 관리자가 해당 앱에서 직접 동의합니다). CLI 값이 환경 변수보다 우선하며, 빈 값은 시작시 실패합니다.

조직/직장 모드

직장/학교 기능(Teams, SharePoint 등)에 접근하려면 다음 플래그 중 하나로 조직 모드를 활용하십시오:

{
  "mcpServers": {
    "ms365": {
      "command": "npx",
      "args": ["-y", "@a-impact/ms365-mcp", "--org-mode"]
    }
  }
}

직장 계정 터 사용 기능에 접근하려면 조직 모드를 처음부터 활성화해야 합니다. 이 플래그가 없으면 사용자 모드 계정 기능(이메일, 일정, OneDrive 등)만 사용할 수 있습니다.

공유 사물함 액세스

공유 사서함에 액세스하려면 다음이 필요합니다:

  1. 조직 모드: 공유 사서함 도구는 --org-mode 플래그가 필요합니다(직장/학교 계정만 해당).

  2. 위임된 사용 권한: 읽기에는 Mail.Read.Shared, 메시지 만들기/업데이트/이동에는 Mail.ReadWrite.Shared, 보내기/회신/전달에는 Mail.Send.Shared, 공유 일정 도구는 Calendars.Read.Shared.

  3. Exchange 권한: 로그인한 사용자는 공유 사서함에 액세스 권한이 부여되어야 합니다.

  4. 사용 방법: 공유 사서함 도구에서 user-id 매개변수에 공유 사서함의 전자메일 주소를 사용합니다.

공유 메일 찾기: list-users 도구를 사용해 조직에서 사용할 수 있는 사용자와 공유 사서함을 검색하세요.

예: list-shared-mailbox-messages와 함께 user-id를 shared-mailbox@company.com으로 설정

시작 예제

Claude Desktop에서 로그인 테스트:

Login example

예시

Image

통합

Claude Desktop

Claude Desktop에 이 MCP 서버를 추가하려면 설정(Settings) > 개발자(Developer) 의 구성 파일을 편집하십시오.

개인 계정 (MSA)

{
  "mcpServers": {
    "ms365": {
      "command": "npx",
      "args": ["-y", "@a-impact/ms365-mcp"]
    }
  }
}

직장/학교 계정 (글로벌)

{
  "mcpServers": {
    "ms365": {
      "command": "npx",
      "args": ["-y", "@a-impact/ms365-mcp", "--org-mode"]
    }
  }
}

직장/학교 계정 (중국 21Vianet)

{
  "mcpServers": {
    "ms365-china": {
      "command": "npx",
      "args": ["-y", "@a-impact/ms365-mcp", "--org-mode", "--cloud", "china"]
    }
  }
}

Claude Code CLI

개인 계정 (MSA)

claude mcp add ms365 -- npx -y @a-impact/ms365-mcp

직장/학교 계정 (글로벌)

# macOS/Linux
claude mcp add ms365 -- npx -y @a-impact/ms365-mcp --org-mode

# Windows (use cmd /c wrapper)
claude mcp add ms365 -s user -- cmd /c "npx -y @a-impact/ms365-mcp --org-mode"

직장/학교 계정 (중국 21Vianet)

# macOS/Linux
claude mcp add ms365-china -- npx -y @a-impact/ms365-mcp --org-mode --cloud china

# Windows (use cmd /c wrapper)
claude mcp add ms365-china -s user -- cmd /c "npx -y @a-impact/ms365-mcp --org-mode --cloud china"

MCP를 지원하는 다른 인터페이스에 대해서는 각 문서의 특정 통합 방법을 참조하세요.

Open WebUI

Open WebUI는 OAuth 2.1을 통한 HTTP 전송 방식의 MCP 서버를 지원합니다.

  1. HTTP 모드로 서버를 시작합니다:

    npx @a-impact/ms365-mcp --http
  2. Open WebUI에서 Admin Settings → Tools (/admin/settings/tools) → Add Connection 이동합니다:

    • Type: MCP Streamable HTTP

    • URL: /mcp 경로에 있는 MCP 서버 URL

    • Auth: OAuth 2.1

  3. Register Client 클릭합니다.

참고: HTTP 모드에서는 동적 클라이언트 등록이 기본적으로 활성화되어 있습니다. 비활성화하려면 --no-dynamic-registration(또는 MS365_MCP_DISABLE_DCR=true)을 사용하세요. 사용자 지정 Azure Entra 앱을 사용하는 경우 리디렉트 URI의 앱 플랫폼 유형은 앱에 클라이언트 암호 유무에 따라 다릅니다. 암호가 있으면 "Web"을, 없으면 "Mobile and desktop applications"을 사용하세요. ("Single-page application"은 사용하지 마세요.)

간편 테스트 구성 — 기본 Azure 앱 사용 (ID ms-365와 localhost:8080은 함께 미리 구성됨):

docker run -d -p 8080:8080 \
  -e WEBUI_AUTH=false \
  -e OPENAI_API_KEY \
  ghcr.io/open-webui/open-webui:main

npx @a-impact/ms365-mcp --http

그런 다음 URL http://localhost:3000/mcp, ID ms-365로 연결을 추가하세요.

Open WebUI MCP Connection

Docker에서 리버스 프록시를 사용 중이십니까? --public-url https://your-domain.com을 설정하여 사용자 브라우저에서 OAuth 인증 URL에 접근할 수 있도록 하십시오. 전체 가이드는 docs/deployment.md를 참고하세요.

로컬 개발

로컬 개발 또는 테스트를 위해:

# From the project directory
claude mcp add ms -- npx tsx src/index.ts --org-mode

또는 Claude Desktop 수동 구성:

{
  "mcpServers": {
    "ms365": {
      "command": "node",
      "args": ["/absolute/path/to/ms-365-mcp-server/dist/index.js", "--org-mode"]
    }
  }
}

참고: 코드 변경 후 dist/ 폴더를 업데이트하려면 npm run build를 실행하세요.

###인증

⚠️ 도구를 사용하려먼 먼저 인증을 수행해야 합니다.

서버는 세 가지 인증 방법을 지원합니다:

1. 장치 코드 흐름 (기본)

장치 코드를 통한 대화형 인증:

  • MCP 클라이언트 로그인:

    • login 도구 호출 (전 기존 토큰 자동 확인)

    • 필요한 경우 URL+코드를 받고 브라우저에서 방문

    • verify-login 도구를 사용하여 확인

  • CLI 로그인:

    npx @a-impact/ms365-mcp --login

    터미널에 표시된 URL과 코드를 따라가십시오.

토큰은 OS 자격 증명 저장소에 안전하게 캐시됩니다(없는 경우 파일 저장).

  1. OAuth 인증 코드 흐름 (HTTP 모드 전용)

--http로 실행하면 서버가 OAuth 인증을 필수로 요구합니다:

npx @a-impact/ms365-mcp --http 3000

이 모드는:

  • MCP 클라이언트에게 OAuth 기능을 공지

  • /auth/* (authorize, token, metadata) 엔드포인트 제공

  • 모든 MCP 요청에 Authorization: Bearer <token> 필수

  • Microsoft Graph API로 토큰 유효성 검증

  • 기본적으로 로그인/로그아웃 도구를 비활성화 (활성화하려면 --enable-auth-tools 사용)

MCP 클라이언트가 공지된 기능을 확인하면 OAuth 흐름이 자동으로 처리됩니다.

OAuth 테스트를위한 Azure AD 구성

OAuth 모드를 자체 Azure 자격을 사용하려면 (프로덕션 권장) Azure AD 앱 등록을 설정해야 합니다:

  1. Azure AD 앱 등록 만들기:

  • Azure 포털로 이동

  • Azure Active Directory → App registrations → New registration로 이동

  • 이름 설정: "MS300 MCP Server"

  1. 리디렉트 URI 구성:

  • OAuth 콜백 URI 구성: 앱 등록 페이지로 이동하고 왼쪽에서 Authentication(인증)으로 갑니다.

  • 플랫폼 구성에서:

    • 플랫폼 추가를 클릭합니다("Mobile and desktop applications" / "Public client"이 이미 보이지 않는 경우).

    • "Mobile and desktop applications" 또는 "Public client/native (mobile & desktop)"을 선택합니다(레이블은 포털 버전에 따라 다름).

  1. MCP Inspector로 테스트(npm run inspector):

  • 앱 등록 페이지로 이동하고 왼쪽에서 Authentication(인증)으로 갑니다.

  • 플랫폼 구성에서:

    • 플랫폼 추가를 클릭합니다("Web"이 이미 보이지 않는 경우).

    • Web을 선택합니다.

    • 다음 리디렉션 URI를 구성합니다.

      • http://localhost:6274/oauth/callback

      • http://localhost:6274/oauth/callback/debug

      • http://localhost:3000/callback (선택 사항, 서버 콜백용)

  1. 자격 증명 가져오기:

  • 개요 페이지에서 Application (client) ID를 복사합니다.

  • Certificates & secrets → 새 클라이언트 암호(New client secret) → 암호 값을 복사합니다(공용 앱에서는 선택 사항).

  1. 환경 변수 구성: 프로젝트 루트에 .env 파일을 만듭니다.

    MS365_MCP_CLIENT_ID=your-azure-ad-app-client-id-here
    MS365_MCP_CLIENT_SECRET=your-secret-here  # Optional for public apps
    MS365_MCP_TENANT_ID=common

이렇게 구성하면 서버는 기본 제공 앱 대신 사용자 지정 Azure 앱을 사용합니다.

참고: .env는 서버가 시작된 디렉터리에서 읽으며, 그 디렉터리는 MCP 클라이언트가 결정합니다. 읽히는 변수는 MS365_MCP_CLIENT_ID, MS365_MCP_CLIENT_SECRET, MS365_MCP_TENANT_ID 및 MS365_MCP_CLOUD_TYPE뿐입니다. 위에 나열된 다른 모든 변수는 셸 또는 MCP 클라이언트 구성에 설정해야 하며, .env에서 발견된 그 외의 값은 스터디 출력에 경고를 내보내고 무시됩니다.

3. Bring Your Own Token (BYOT)

Microsoft OAuth 토큰을 외부에서 관리하는 더 큰 시스템의 일부로 ms-365-mcp-server를 실행하는 경우, 액세스 토큰을 이 MCP 서버에 직접 제공할 수 있습니다.

MS365_MCP_OAUTH_TOKEN=your_oauth_token npx @a-impact/ms365-mcp

이 방법은:

  • 대화형 인증 흐름을 건너뜁니다.

  • Microsoft Graph API 요청에 기존 OAuth 토큰을 사용합니다.

  • 토큰 새로 고침은 처리하지 않습니다(토큰 수명 주기 관리는 사용자 책임).

참고: HTTP 모드에서는 인증이 필요합니다. 인증 없이 테스트하려면 장치 코드 흐름과 함께 stdio 모드를 사용하세요.

인증 도구: HTTP 모드에서는 OAuth가 인증을 처리하므로 로그인/로그아웃 도구가 기본적으로 비활성화됩니다. 필요하면 --enable-auth-tools를 사용하세요.

다중 계정 지원

단일 서버 인스턴스로 여러 Microsoft 계정을 처리할 수 있습니다. 계정이 둘 이상 로그인되어 있으면 모든 도구에 account 매개변수가 자동으로 추가되어, 호출별로 사용할 계정을 지정할 수 있습니다.

여러 계정 로그인(계정마다 한 번):

# Login first account (device code flow)
npx @a-impact/ms365-mcp --login
# Follow the device code prompt, sign in as personal@outlook.com

# Login second account
npx @a-impact/ms365-mcp --login
# Follow the device code prompt, sign in as work@company.com

구성된 계정 목록 표시:

npx @a-impact/ms365-mcp --list-accounts

도구 호출에 사용: 모든 도구 요청에 "account": "work@company.com"을 전달합니다.

{ "tool": "list-mail-messages", "arguments": { "account": "work@company.com" } }

동작:

  • 단일 계정이 구성되어 있으면 자동으로 선택됩니다(account 매개변수 불필요).

  • 여러 계정이 있고 account 매개변수가 없으면, 서버는 선택된 기본 계정을 사용하거나 사용 가능한 계정을 나열하는 도움말 오류를 반환합니다.

  • 100% 하위 호환: 기존 단일 계정 설정은 변경 없이 그대로 작동합니다.

  • account 매개변수는 이메일 주소(예: user@outlook.com) 또는 MSAL homeAccountId를 허용합니다.

엄격한 계정 고정

헤드리스 stdio 배포에서는 로컬 MSAL 캐시를 특정 Microsoft 계정 하나에 고정할 수 있습니다.

# Username matching is case-insensitive
MS365_MCP_EXPECTED_USERNAME=work@company.com npx @a-impact/ms365-mcp --login

# Or pin the exact MSAL homeAccountId shown by --list-accounts
npx @a-impact/ms365-mcp --expected-home-account-id <homeAccountId> --login

--list-accounts를 사용하여 homeAccountId 값을 확인하세요. MCP list-accounts 도구는 의도적으로 계정 ID를 숨기므로 정확한 ID 고정에는 CLI를 사용해야 합니다.

고정은 선택 사항이며 로컬 MSAL에만 적용됩니다:

  • CLI 값(--expected-username, --expected-home-account-id)이 MS365_MCP_EXPECTED_USERNAME 및 MS365_MCP_EXPECTED_HOME_ACCOUNT_ID보다 우선합니다.

  • 빈 고정 값을 제공하면 무시되지 않고 시작 시 실패합니다.

  • 사용자 이름 고정은 대/소문자를 구분하지 않으며, homeAccountId 고정은 정확히 일치해야 합니다.

  • 두 고정을 모두 설정한 경우 동일한 캐시된 계정으로 확인되어야 합니다.

  • 로컬 stdio 시작 시 예상 계정이 토큰 캐시에 없으면 즉시 실패합니다. 고정을 설정하고, --login을 실행한 다음, 헤드리스 서버를 시작하는 방식으로 부트스트랩합니다.

  • 장치 코드 및 브라우저 로그인은 선택한 계정이나 토큰 캐시를 저장하기 전에 누락되었거나 일치하지 않는 계정을 거부합니다.

  • 고정을 사용하면 유효 MCP 모드가 단일 계정으로 좁혀집니다. 서버는 account 매개변수를 광고하지 않으며 MCP 지침도 계정 전환을 제안하지 않습니다.

  • --http, --obo 및 MS365_MCP_OAUTH_TOKEN은 Graph 호출에 요청 제공 토큰을 사용하므로 해당 모드에서는 계정 고정이 경고에만 적용됩니다. HTTP 인증 도구가 활성화된 경우 고정은 여전히 해당 로컬 MSAL 도우미 흐름에 적용됩니다.

  • --logout은 고정 계정을 포함한 모든 캐시된 계정을 지웁니다. 부분 정리를 원하면 --remove-account <id>를 사용하는 것이 좋습니다.

MCP 멀티플렉서(Legate, Governor)의 경우: 다중 계정 모드는 N-프로세스 패턴을 대체합니다. 계정당 하나의 서버를 실행하는 대신 단일 인스턴스가 account 매개변수를 통해 모든 계정을 처리하므로 도구 중복이 N×110에서 110으로 줄어듭니다.

도구 프리셋

초기 연결 오버헤드와 토큰 사용을 줄이기 위해 전체 도구 세트 대신 프리셋 도구 범주를 사용하세요.

npx @a-impact/ms365-mcp --preset mail
npx @a-impact/ms365-mcp --list-presets  # See all available presets

사용 가능한 프리셋: mail, calendar, files, personal, work, excel, contacts, tasks, onenote, search, users, outlook, onedrive, teams, teams-write, all

endpoints.json의 각 엔드포인트는 presets 배열을 통해 어떤 프리셋에 속하는지 선언하므로 모든 프리셋은 정확한 도구 이름 허용 목록이며 앱을 초과하는 일치가 없습니다(예: mail은 공유 사서함 도구를 포함하지 않으며, 그 도구는 work에 있습니다). 범용 이진 리더인 download-bytes는 teams-write를 제외한 모든 프리셋에 포함되어 있으므로 앱이 반환하는 것이 무엇이든(파일, 첨부, 사진, 녹음) 항상 가져올 수 있습니다. get-download-url(드라이브/SharePoint 파일에 대한 사전 인증 URL)은 드라이브 기반 프리셋과 함께 제공됩니다. 따라서 파일을 찾을 수 있는 프리셋은 항상 해당 파일의 바이트를 읽을 수 있습니다.

outlook, onedrive 및 teams 프리셋은 앱 범위입니다. 정확히 하나의 Microsoft 앱을 노출합니다. "정확히 하나의 앱만 노출" 배포에 사용하세요.

# Outlook only (mail + calendar + contacts; no shared mailboxes, no files)
npx @a-impact/ms365-mcp --preset outlook

# Teams only (requires --org-mode)
npx @a-impact/ms365-mcp --org-mode --preset teams

teams-write 프리셋은 --read-only의 보내기 전용 대응입니다. 채팅에서 보내기, 채널에서 보내기/회신, 이름으로 채팅/팀/채널 나열, 활동 알림 — 메시지 읽기와 바이트 다운로더는 없습니다. 요청된 토큰은 구조적으로 최소입니다(Chat.ReadBasic, *.Send 범위, 기본 팀/채널 목록 — 메시지 내용을 읽을 수 있는 것이 없음).

npx @a-impact/ms365-mcp --org-mode --preset teams-write

동적 도구 검색

모든 도구를 미리 로드하는 대신 동적 검색을 사용하면 LLM이 필요할 때만 도구를 찾아 로드할 수 있습니다.

npx @a-impact/ms365-mcp --discovery

초기 컨텍스트를 작게 유지하고 토큰 사용량을 줄여줍니다. 특히 긴 세션이나 비용에 민감한 환경(예: 유료 API를 사용하는 Open WebUI)에서 유용합니다.

CLI 옵션

ms-365-mcp-server를 명령줄에서 직접 실행할 때 다음 옵션을 사용할 수 있습니다.

--login           Login using device code flow
--logout          Log out and clear saved credentials
--verify-login    Verify login without starting the server
--list-permissions List required Graph API permissions and exit (respects --org-mode, --preset, --enabled-tools, --allowed-scopes)
--org-mode        Enable organization/work mode from start (includes Teams, SharePoint, etc.)
--work-mode       Alias for --org-mode
--force-work-scopes Backwards compatibility alias for --org-mode (deprecated)
--cloud <type>    Microsoft cloud environment: global (default) or china (21Vianet)
--allowed-scopes <scopes> Limit exposed tools to Graph scopes covered by this allowlist
--extra-scopes <scopes> Append additional Graph scopes to the token request (for use with your own app registration + graph-batch)
--expected-username <username> Require local MSAL auth to use this account username
--expected-home-account-id <id> Require local MSAL auth to use this exact homeAccountId

서버 옵션

MCP 서버로 실행할 때 다음 옵션을 사용할 수 있습니다.

-v                Enable verbose logging
--read-only       Start server in read-only mode, disabling write operations
--http [port]     Use Streamable HTTP transport instead of stdio (optionally specify port, default: 3000)
                  Starts Express.js server with MCP endpoint at /mcp
--enable-auth-tools Enable login/logout tools when using HTTP mode (disabled by default in HTTP mode)
--no-dynamic-registration Disable OAuth Dynamic Client Registration (enabled by default in HTTP mode)
--enabled-tools <pattern> Filter tools using regex pattern (e.g., "excel|contact" to enable Excel and Contact tools)
--preset <names>  Use preset tool categories (comma-separated). See "Tool Presets" section above
--list-presets    List all available presets and exit
--toon            (experimental) Enable TOON output format for 30-60% token reduction
--discovery       Dynamic tool discovery: loads tools on demand to reduce initial token usage (see "Dynamic Tool Discovery" above)
--public-url <url> Public base URL for OAuth when behind a reverse proxy (see Open WebUI section and docs/deployment.md)

환경 변수:

  • READ_ONLY=true|1: --read-only 플래그 대안

  • ENABLED_TOOLS: regex 패턴으로 도구 필터링(--enabled-tools 플래그 대안)

  • MS365_MCP_ORG_MODE=true|1: 조직/업무 모드 활성화(--org-mode 플래그 대안)

  • MS365_MCP_FORCE_WORK_SCOPES=true|1: 이전 MS365\_MCP\_ORG\_MODE에 대한 하위 호환성

  • MS365_MCP_OUTPUT_FORMAT=toon: TOON 출력 형식 활성화(--toon 플래그 대안)

  • MS365_MCP_MAX_TOP=<n>: 목록 요청에서 Graph $top / top에 대한 상한(양의 정수). 모델이 더 큰 값을 전달하면 서버가 n으로 제한하여 응답이 더 작아지도록 유지합니다. 예: MS365_MCP_MAX_TOP=15

  • MS365_MCP_MAX_PAGES=<n>: fetchAllPages: true로 도구를 호출할 때 추적할 최대 페이지 수(양의 정수, 기본값 100). 큰 결과 집합의 메모리와 지연 시간을 제한합니다.

  • MS365_MCP_MAX_ITEMS=<n>: fetchAllPages: true일 때 누적될 최대 항목 수(양의 정수, 기본값 10000). 항목이 이만큼 모이면 페이지 추적이 멈추고 응답이 잘립니다.

  • MS365_MCP_ALLOW_PAGINATION=0|false|no: 다중 페이지 추적을 완전히 비활성화합니다. 설정하면 fetchAllPages 매개변수가 도구에 선전하지 않으며, 여전히 전달하는 요청은 첫 번째 페이지만 반환합니다(기본값: 페이지네이션 활성화).

  • MS365_MCP_BODY_FORMAT=html: 이메일 본문을 일반 텍스트 대신 HTML로 반환(기본값: text)

  • MS365_MCP_MESSAGE_SIGNOFF_PREFIX=<text>: 보내는 메시지 앞에 붙는 서명 접두어로, 수신자가 에이전트가 보낸 것임을 알 수 있게 합니다(예: 🤖). 기본값: 없음. CLI 등가: --message-signoff-prefix <text> (아래 Message Signoff 참조)

  • MS365_MCP_MESSAGE_SIGNOFF_SUFFIX=<text>: 보내메시지 뒤에 붙는 서명. 기본값: 없음. CLI 등가: --message-signoff-suffix <text>. --no-message-signoff는 둘 다 비활성화합니다(아래 "Message Signoff" 참조)

  • MS365_MCP_RATE_LIMIT_DISABLED=true|1: HTTP 모드에서 IP별 요청 속도 제한을 비활성화(기본값: 활성화 — /authorize, /token, /register에 분당 30회; /mcp에 분당 120회)

  • MS365_MCP_TRUST_PROXY_HOPS=<n>: HTTP 모드에서 신뢰할 리전스 프록시 홉 수(기본값 1). 정확한 IP별 요청 제한은 이 값이 배포 환경과 일치하는지에 따라 달라집니다 — 서버 앞의 프록시 수, 원시 소켓 피어 IP를 사용하려면 0, 또는 쉼표로 구분된 서브넷 목록으로 설정

  • MS365_MCP_CLOUD_TYPE=global|china: Microsoft 클라우드 환경(--cloud 플래그 대안)

  • LOG_LEVEL: 로그 수준 설정(기본값: 'info')

  • SILENT=true|1: 콘솔 출력 비활성화

  • MS365_MCP_REDACT_PII=false|0: 로그 메시지에서 JWT, Bearer 헤더, OAuth 토큰 필드 및 이메일 주소의 난독(scrubbing) 비활성화(기본값: 활성화). 서버는 실시간 Graph 베어러 토큰을 처리하므로 전체 상세한 로컬 디버깅을 위해 명시적으로 변경하지 않는 한 난독화는 켜져 있습니다.

  • MS365_MCP_CLIENT_ID: 사용자 지정 Azure 앱 클라이언트 ID(기본 제공 앱 대신)

  • MS365_MCP_TENANT_ID: 사용자 지정 테넌트 ID(다중 테넌트의 기본값은 'common'). 개인 Microsoft 계정은 이것을 consumers로 설정해야 합니다 — 2026년 6월 현재 기본 'common' 인증기관에서 발급된 새로고침 토큰은 처음 새로고침에서 거부되므로 로그인 후 약 1시간 이내에 세션이 중단됩니다

  • MS365_MCP_OAUTH_TOKEN: Microsoft Graph API용 기존 OAuth 토큰(BYOT 방식)

  • MS365_MCP_KEYVAULT_URL: 비밀번호 관리용 Azure Key Vault URL(Azure Key Vault 섹션 참조)

  • MS365_MCP_TOKEN_CACHE_PATH: MSAL 토큰 캐시의 사용자 지정 파일 경로(아래 토큰 저장 참조)

  • MS365_MCP_SELECTED_ACCOUNT_PATH: 선택된 계정 메타데이터의 사용자 지정 파일 경로(아래 토큰 저장 참조)

  • MS365_MCP_AUTH_CACHE_COMMAND: 공급자 중립 인증-캐시 저장용 외부 실행 래퍼(아래 토큰 저장 참조)

  • MS365_MCP_AUTH_CACHE_COMMAND_TIMEOUT_MS: MS365_MCP_AUTH_CACHE_COMMAND 호출당 시간 초과(기본값: 10000)

  • MS365_MCP_EXPECTED_USERNAME: 로컬 MSAL 인증이 이 Microsoft 계정 사용자 이름을 사용하도록 요구(대/소문자를 구분하지 않음; CLI 플래그가 우선)

  • MS365_MCP_EXPECTED_HOME_ACCOUNT_ID: 로컬 MSAL 인증이 이 정확한 MSAL homeAccountId를 사용하도록 요구(CLI 플래그가 우선)

토큰 저장

인증 토큰은 암호화된 파일(AES-256-GCM)에 저장됩니다. 32바이트 암호화 키만 keytar의 운영 체제 자격 증명 저장소로 이동합니다.

캐시 자체는 일부 자격 증명 저장소가 담기에는 너무 큽니다. Windows 자격 증명 관리자 Blob은 2560바이트로 제한되고 실제 토큰 캐시는 그 몇 배이므로, Windows에서는 쓰기가 성공할 수 없었습니다. 키는 계정 수와 관계없이 32바이트이므로 모든 플랫폼에서 동일하게 작동합니다.

기본 경로는 사용자별 구성 디렉터리에 있습니다.

플랫폼

위치

Windows

%APPDATA%\ms-365-mcp-server\

macOS

~/Library/Application Support/ms-365-mcp-server/

Linux

$XDG_CONFIG_HOME/ms-365-mcp-server/ (또는 ~/.config/ms-365-mcp-server/)

이전 버전은 설치된 패키지 내부의 경로를 기본값으로 사용했는데, npx에서는 콘텐츠 해시 기반 캐시 디렉터리로 확인되며 npm cache clean이나 버전 업데이트 시 삭제됩니다. 패키지 디렉터리에 남아 있는 캐시는 첫 실행 시 새 위치로 이동됩니다.

이 방식은 전역 및 로컬 설치와 해시가 변경되지 않은 npx에 적용됩니다. 이전 npx 해시 디렉터리에 남겨진 캐시에는 접근할 수 없으므로, npx 설치를 마지막으로 한 번 더 업그레이드하면 다시 로그인해야 합니다. 다른 디렉터리에서 캐시를 가져오는 것은 이 패키지가 자신이 기록했다는 것을 증명할 수 없는 디렉터리를 신뢰해야 한다는 뜻이며, 로그인 한 번을 아끼기에는 그만한 가치가 없습니다.

필요한 경우 경로를 재정의할 수 있습니다:

export MS365_MCP_TOKEN_CACHE_PATH="$HOME/.config/ms365-mcp/.token-cache.json"
export MS365_MCP_SELECTED_ACCOUNT_PATH="$HOME/.config/ms365-mcp/.selected-account.json"

상위 디렉터리는 자동으로 생성됩니다. 파일은 0600 권한으로 기록됩니다.

자격 증명 저장소가 없는 경우(헤드리스 Linux, 대부분의 컨테이너)에는 키가 캐시 파일 옆의 .cache-key에 0600 권한으로 기록됩니다. 이렇게 하면 토큰이 우연한 cat 실행, 백업, 실수로 인한 커밋에 노출되지 않습니다. 이미 디렉터리를 읽을 수 있는 사용자로부터는 보호되지 않습니다. 키가 바로 그곳에 있기 때문입니다. 실제 비밀 저장소에 캐시가 필요하다면 아래의 MS365_MCP_AUTH_CACHE_COMMAND를 사용하세요.

캐시를 해독할 수 없다면(키 분실, 키체인 잠김, 파일 수정) 서버가 시작되지 못하는 대신 다시 로그인하라는 메시지가 표시됩니다. 캐시 파일은 그대로 유지됩니다. 삭제되지도 않고 새 로그인으로 덮어쓰지도 않습니다. 단순히 잠겨 있는 키체인은 대개 다음 시작 시 정상적으로 읽히며, 그때 캐시도 그대로 남아 있습니다.

그 대가로 이 상황이 지속되는 동안에는 새 세션이 저장되지 않으므로 시작할 때마다 다시 로그인해야 합니다. 키가 진짜로 유실되어 캐시가 절대 열리지 않는다면 로그가 그 사실을 알리고 경로를 명시하므로 .token-cache.json을 삭제하면 처음부터 다시 시작할 수 있습니다.

호스팅/샌드박스 환경(예: Anthropic Cowork): 세션 간에 토큰을 유지하려면 MS365_MCP_TOKEN_CACHE_PATH와 MS365_MCP_SELECTED_ACCOUNT_PATH를 영구 마운트로 설정하십시오.

외부 인증-캐시 명령

헤드리스 로컬-MSAL 배포에서는 내장 keytar/파일 저장소를 공급자 중립적인 외부 명령으로 대체할 수 있습니다:

export MS365_MCP_AUTH_CACHE_COMMAND="/path/to/ms365-auth-cache-store"
export MS365_MCP_AUTH_CACHE_COMMAND_TIMEOUT_MS=10000

로컬 인증 흐름에서 MS365_MCP_AUTH_CACHE_COMMAND가 설정되면 서버는 MSAL 토큰 캐시 및 선택된 계정 메타데이터에 대해 해당 명령만 사용합니다. keytar나 로컬 파일로 대체(fall back)하지 않습니다. 명령 경로가 없거나 POSIX에서 실행 가능하지 않거나, 0이 아닌 종료 코드를 반환하거나, 시간 초과하거나, 잘못된 형식의 데이터를 반환하면 인증-캐시 작업은 안전하게 실패(fail closed) 처리된 상태에서 정제된 오류 메시지를 반환합니다.

값은 실제 실행 가능한 래퍼 경로여야 합니다. 셸 명령 문자열이 아니며 별도의 인자 환경 변수도 없습니다. 인터프리터, 지역, 프로필, 공급자별 설정은 모두 래퍼 안에 넣으십시오. Windows 사용자는 Node가 셸 구문 해석 없이 직접 실행할 수 있는 래퍼 실행 파일이나 스크립트로 변수를 지정하십시오.

서버는 다음과 같이 래퍼를 호출합니다:

$MS365_MCP_AUTH_CACHE_COMMAND load token-cache
$MS365_MCP_AUTH_CACHE_COMMAND save token-cache
$MS365_MCP_AUTH_CACHE_COMMAND delete token-cache
$MS365_MCP_AUTH_CACHE_COMMAND load selected-account
$MS365_MCP_AUTH_CACHE_COMMAND save selected-account
$MS365_MCP_AUTH_CACHE_COMMAND delete selected-account

프로토콜 v1:

  • load <key>는 표준 입력을 읽지 않습니다. 키가 있으면 {"found":true,"value":"<stored envelope string>"}와 함께 종료 코드 0으로 종료합니다. 캐시 누락 시에는 {"found":false} 또는 빈 표준 출력과 함께 종료 코드 0으로 종료합니다.

  • save <key>는 표준 입력으로 {"value":"<stamped envelope string>"}를 수신하며, 값이 영구적으로 커밋된 후에만 종료 코드 0으로 종료해야 합니다. v1에는 즉시 무시(fire-and-forget) 또는 통합(coalesced) 저장 기능이 없습니다.

  • delete <key>는 표준 입력을 읽지 않고, 키가 존재했는지 여부와 무관하게 종료 코드 0으로 종료합니다.

  • <key>는 token-cache 또는 selected-account입니다.

  • 0이 아닌 종료 코드는 저장소 오류입니다. 캐시 누락을 나타내기 위해 종료 코드 2를 사용하지 마십시오.

  • 표준 오류(stderr)는 캡처되어 정제된 오류 메시지에서 잘릴 수 있습니다. 서버는 stdin과 stdout의 페이로드를 절대 로그에 남기지 않습니다.

  • 토큰 캐시 페이로드는 클 수 있습니다. 래퍼는 최소 256KB 값을 처리해야 합니다.

일반 상태 비저장 HTTP Graph 요청은 로컬 인증-캐시 저장소를 사용하지 않습니다. HTTP 모드에서는 로컬 인증 도구가 명시적으로 활성화되어 있거나 --login, --verify-login, --list-accounts, --select-account, --logout 같은 로컬 계정 명령이 사용되는 경우가 아니라면 명령 저장소는 시작 시와 요청 시 모두 건너뜁니다.

Azure Key Vault 통합

프로덕션 배포의 경우 환경 변수 대신 Azure Key Vault에 비밀을 저장할 수 있습니다. 이는 관리 ID를 사용하는 Azure Container Apps에서 특히 유용합니다.

설정

  1. Key Vault 생성(아직 없는 경우):

    az keyvault create --name your-keyvault-name --resource-group your-rg --location eastus
  2. Key Vault에 비밀 추가:

    az keyvault secret set --vault-name your-keyvault-name --name ms365-mcp-client-id --value "your-client-id"
    az keyvault secret set --vault-name your-keyvault-name --name ms365-mcp-tenant-id --value "your-tenant-id"
    # Optional: if using confidential client flow
    az keyvault secret set --vault-name your-keyvault-name --name ms365-mcp-client-secret --value "your-secret"
  3. Key Vault에 대한 액세스 권한 부여:

    관리 ID를 사용하는 Azure Container Apps의 경우:

    # Get the managed identity principal ID
    PRINCIPAL_ID=$(az containerapp show --name your-app --resource-group your-rg --query identity.principalId -o tsv)
    
    # Grant access to Key Vault secrets
    az keyvault set-policy --name your-keyvault-name --object-id $PRINCIPAL_ID --secret-permissions get list

    Azure CLI를 사용한 로컬 개발의 경우:

    # Your Azure CLI identity already has access if you have appropriate RBAC roles
    az login
  4. 서버 구성:

    MS365_MCP_KEYVAULT_URL=https://your-keyvault-name.vault.azure.net npx @a-impact/ms365-mcp

비밀 이름 매핑

Key Vault 비밀 이름

환경 변수

필수

ms365-mcp-client-id

MS365_MCP_CLIENT_ID

예

ms365-mcp-tenant-id

MS365_MCP_TENANT_ID

아니요 (기본값: 'common')

ms365-mcp-client-secret

MS365_MCP_CLIENT_SECRET

아니요

인증

Key Vault 통합은 Azure Identity SDK의 DefaultAzureCredential을 사용하며, 이는 여러 인증 방법을 순서대로 자동으로 시도합니다:

  1. 환경 변수 (AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, AZURE_TENANT_ID)

  2. 관리 ID (Azure Container Apps 권장)

  3. Azure CLI 자격 증명 (로컬 개발용)

  4. Visual Studio Code 자격 증명

  5. Azure PowerShell 자격 증명

선택적 종속성

Azure Key Vault 패키지(@azure/identity, @azure/keyvault-secrets)는 선택적 종속성입니다. MS365_MCP_KEYVAULT_URL이 설정되어 있어야지만 로드됩니다. Key Vault를 사용하지 않으면 이 패키지가 필요하지 않습니다.

메시지 서명

외부 전송 메시지에는 구성 가능한 서명(예: 🤖 접두사)을 붙일 수 있어, 수신자가 에이전트가 보낸 메시지와 직접 입력한 메시지를 구분할 수 있습니다. 기본적으로 꺼져 있으며, --message-signoff-prefix / --message-signoff-suffix(환경 변수: MS365_MCP_MESSAGE_SIGNOFF_PREFIX / MS365_MCP_MESSAGE_SIGNOFF_SUFFIX)로 활성화할 수 있습니다. --no-message-signoff 또는 빈 환경 변수 값으로 다시 끌 수 있습니다.

일단 구성하면 이 기능은 모든 Teams 메시지(전송, 답변, 편집 – graph-batch 경유 포함), 직접 메일 전송(send-mail, 답장/전달, 해당 공유 사서함 변형, 그룹 스레드 답장), 그리고 초안 내용이 작성될 때 메일 초안에 적용됩니다. send-draft-message는 초안을 그대로 보내므로 직접 작성한 초안은 변경되지 않은 채로 전송됩니다. 이미 마커가 있는 메시지에는 두 번 서명하지 않으며, 본문에 서명을 넣을 수 없는 전송은 서명 없이 보내지 않고 거부됩니다.

마커는 시각적인 텍스트를 만드는 한 마크업(예: 색상이 적용된 <span>)을 포함할 수 있습니다. 이 서명은 에이전트가 제공받은 도구를 오용하는 것을 막기 위한 안전장치일 뿐, 안전한 경계선으로 사용할 수는 없습니다. 같은 시스템에서 셸에 접근할 수 있는 에이전트는 서명 없이 서버를 그냥 다시 시작하기만 하면 됩니다.

프로덕션 배포

조직 전체에서 액세스할 수 있도록 서버를 호스팅하는 전체 가이드(Docker, Azure Container Apps, Azure App Service, Azure AD 앱 등록, 역방향 프록시 설정, 클라이언트 구성, 노출되는 엔드포인트 포함)는 docs/deployment.md를 참조하세요.

기여

기여를 환영합니다! Pull Request를 제출하기 전에 변경 사항이 우리의 품질 기준을 충족하는지 확인하십시오.

모든 코드 품질 요구 사항을 확인하려면 검증 스크립트를 실행하세요:

npm run verify

개발자를 위한

저장소를 클론한 후, Microsoft Graph OpenAPI 사양에서 클라이언트 코드를 생성해야 할 수도 있습니다:

npm run generate

관련 프로젝트

  • ms-365-admin-mcp-server — @okapi-ca 제작: application permissions(클라이언트 자격 증명 흐름)을 사용하는 관리자/데몬 시나리오용 보조 서버이며, 보안 경고, 감사 로그, 서비스 상태 및 사용 제한 보고서를 제공합니다.

지원

문제가 발생하거나 도움이 필요하면:

라이선스

MIT © 2026 A-Impact

Available Tools

188 tools
accept-calendar-eventaccept-calendar-eventA
Destructive

Accept the specified event in a user calendar.

💡 TIP: Accepts a meeting invitation. Optional body: { sendResponse: true, comment: 'I will attend.' }. Set sendResponse to false to accept silently without notifying the organizer.

Inputs: body (required), eventId (required), confirm, includeHeaders, +1 more.

add-excel-table-rowsadd-excel-table-rowsA
Destructive

Add Excel table rows.

💡 TIP: Adds rows to a table. Body: { values: [['col1val', 'col2val', 'col3val'], ['row2col1', 'row2col2', 'row2col3']] }. Each inner array is one row. Values must match the number of columns in the table.

Inputs: body (required), driveId (required), driveItemId (required), workbookTableId (required), +3 more.

add-mail-attachmentadd-mail-attachmentA
Destructive

Use this API to create a new Attachment. An attachment can be one of the following types: All these types of attachment resources are derived from the attachment resource.

💡 TIP: The only path for attachments under 3MB. contentBytes must carry the complete base64 verbatim; a truncated argument fails with 400 UnableToDeserializePostBody. At 3MB and above use create-mail-attachment-upload-session, which rejects anything smaller. Body requires @odata.type: {"@odata.type": "#microsoft.graph.fileAttachment", "name": "file.pdf", "contentBytes": ""}.

Inputs: body (required), messageId (required), confirm, includeHeaders, +1 more.

cancel-calendar-eventcancel-calendar-eventA
Destructive

This action allows the organizer of a meeting to send a cancellation message and cancel the event. The action moves the event to the Deleted Items folder. The organizer can also cancel an occurrence of a recurring meeting by providing the occurrence event ID. An attendee calling this action gets an error (HTTP 400 Bad Request), with the following error message: 'Your request can't be completed. You need to be an organizer to cancel a meeting.' This action differs from Delete in that Cancel is available to only the organizer, and lets the organizer send a custom message to the attendees about the cancellation.

💡 TIP: Cancels a meeting (organizer only) and sends a cancellation message to all attendees. Body: { Comment (optional string, custom message) }. Use this instead of delete-calendar-event when you want attendees to see 'Canceled' in their calendar. Attendees calling this get HTTP 400 — they should use decline-calendar-event instead.

Inputs: body (required), eventId (required), confirm, includeHeaders, +1 more.

clear-excel-rangeclear-excel-rangeA
Destructive

Clear an Excel range.

💡 TIP: Clear cell contents and/or formatting on the given range. Body: { applyTo: 'All' | 'Formats' | 'Contents' }. 'Contents' wipes values but keeps formatting; 'Formats' resets styling but keeps values; 'All' wipes both. Use this to reset a worksheet section before a fresh write rather than overwriting cell-by-cell.

Inputs: body (required), address (required), driveId (required), driveItemId (required), +4 more.

copy-drive-itemcopy-drive-itemA
Destructive

Copy a drive item.

💡 TIP: Asynchronously copy a file or folder to a new location and/or name. Body: { parentReference: { driveId: '...', id: '...' }, name?: 'New Name.xlsx' }. Returns 202 Accepted with a Location header pointing at a monitor URL for the async job. Ideal for duplicating templates (e.g. clone an Armhr Census Template per prospect), bulk file provisioning, or preserving an immutable snapshot of a working file.

Inputs: body (required), driveId (required), driveItemId (required), confirm, +2 more.

copy-mail-messagecopy-mail-messageA
Destructive

Copy a message to a folder within the user's mailbox.

💡 TIP: Copies a message to another mail folder. Body: { DestinationId: '<mailFolder-id or well-known name like inbox, archive, junkemail>' }. Returns the newly created message (with a new id) in the destination folder. For moving instead of copying, use move-mail-message.

Inputs: body (required), messageId (required), confirm, includeHeaders, +1 more.

create-calendarcreate-calendarA
Destructive

Create a new calendar for a user.

💡 TIP: Creates a new personal calendar. Body: { name: 'My Calendar', color: 'auto' }. Available colors: auto, lightBlue, lightGreen, lightOrange, lightGray, lightYellow, lightTeal, lightPink, lightBrown, lightRed, maxColor.

Inputs: body (required), confirm, includeHeaders, excludeResponse.

create-calendar-eventcreate-calendar-eventB
Destructive

Create (schedule) a new calendar event — a meeting or appointment — on the user's calendar. Set subject, start/end times, time zone, location, body, and attendees; supports online meetings and recurrence.

💡 TIP: CRITICAL: Do not try to guess the email address of the recipients. Use the list-users tool to find the email address of the recipients.

Inputs: body (required), confirm, includeHeaders, excludeResponse.

create-contact-child-foldercreate-contact-child-folderA
Destructive

Create a new contactFolder as a child of a specified folder. You can also create a new contactFolder under the user's default contact folder.

💡 TIP: Creates a sub-folder under an existing contact folder. Body: { displayName: 'Sub-folder name' }. Use list-contact-folders to discover the parent id. The returned contactFolder has its own id usable with update-contact-folder, delete-contact-folder, list-contact-folder-contacts, and create-contact-in-folder — contactFolder ids are mailbox-unique regardless of nesting depth.

Inputs: body (required), contactFolderId (required), confirm, includeHeaders, +1 more.

create-contact-foldercreate-contact-folderC
Destructive

Create a new contactFolder under the user's default contacts folder. You can also create a new contactfolder as a child of any specified contact folder.

💡 TIP: Creates a new contact folder under the user's mailbox root. Body: { displayName: 'Family' }. Returns the created contactFolder with its id. To create a sub-folder under an existing folder, use create-contact-child-folder.

Inputs: body (required), confirm, includeHeaders, excludeResponse.

create-contact-in-foldercreate-contact-in-folderA
Destructive

Add a contact to the root Contacts folder or to the contacts endpoint of another contact folder.

💡 TIP: Creates a contact inside a specific folder (instead of the default Contacts folder). Body is a contact resource: { givenName, surname, displayName, emailAddresses: [{ address, name }], businessPhones: [], mobilePhone, jobTitle, companyName, ... }. The existing create-outlook-contact (POST /me/contacts) writes to the default folder only; use this when organizing contacts into named folders. Get the folder id via list-contact-folders.

Inputs: body (required), contactFolderId (required), confirm, includeHeaders, +1 more.

create-draft-emailcreate-draft-emailA
Destructive

Create a draft Outlook email message in the signed-in user's Drafts folder. Set subject, body, toRecipients, ccRecipients, and importance. The draft is saved, not sent — use send-mail to send a message directly, or send the draft afterwards.

Inputs: body (required), confirm, includeHeaders, excludeResponse.

create-drive-item-previewcreate-drive-item-previewA
Destructive

Create a drive item preview.

💡 TIP: Generate a short-lived embeddable preview URL for a file (Office docs, PDFs, images). Body: { page?: number | string, zoom?: number, viewer?: 'onedrive' | 'office' }. Returns getUrl (interactive) and postUrl (form-post). Useful for surfacing inline previews in summary emails or chat messages without needing the recipient to open the file.

Inputs: body (required), driveId (required), driveItemId (required), confirm, +2 more.

create-excel-chartcreate-excel-chartC
Destructive

Creates a new chart.

Inputs: body (required), driveId (required), driveItemId (required), workbookWorksheetId (required), +3 more.

create-excel-tablecreate-excel-tableA
Destructive

Create a new table. The range source address determines the worksheet under which the table will be added. If the table can't be added (for example, because the address is invalid, or the table would overlap with another table), an error is generated.

💡 TIP: Convert a worksheet range into a formal Excel table. Body: { address: 'A1:H171', hasHeaders: true }. Required before using add-excel-table-rows / update-excel-table-row / delete-excel-table-row on a plain-cells sheet.

Inputs: body (required), driveId (required), driveItemId (required), workbookWorksheetId (required), +3 more.

create-focused-inbox-overridecreate-focused-inbox-overrideA
Destructive

Create an override for a sender identified by an SMTP address. Future messages from that SMTP address will be consistently classified as specified in the override. Note

💡 TIP: Creates a Focused Inbox override for a sender. Body: { classifyAs: 'focused', senderEmailAddress: { name: 'Display Name', address: 'sender@example.com' } }. classifyAs must be 'focused' or 'other'. If an override already exists for that SMTP address, POST updates the existing override's name and classifyAs (use this to rename a sender). Resolve the sender's address with list-users or by reading a recent mail header — do not invent SMTP addresses.

Inputs: body (required), confirm, includeHeaders, excludeResponse.

create-forward-draftcreate-forward-draftA
Destructive

Create a forward draft.

💡 TIP: Create a forward draft (does not send). Useful when user wants to review before sending.

Inputs: body (required), messageId (required), confirm, includeHeaders, +1 more.

create-mail-attachment-upload-sessioncreate-mail-attachment-upload-sessionA
Destructive

Create an upload session that allows an app to iteratively upload ranges of a file, so as to attach the file to the specified Outlook item. The item can be a message or event. Use this approach to attach a file if the file size is between 3 MB and 150 MB. To attach a file that's smaller than 3 MB, do a POST operation on the attachments navigation property of the Outlook item; see how to do this for a message or for an event. As part of the response, this action returns an upload URL that you can use in subsequent sequential PUT queries. Request headers for each PUT operation let you specify the exact range of bytes to be uploaded. This allows transfer to be resumed, in case the network connection is dropped during upload. The following are the steps to attach a file to an Outlook item using an upload session: See attach large files to Outlook messages or events for an example.

💡 TIP: For attachments 3MB to 150MB. Graph rejects smaller files with ErrorAttachmentSizeShouldNotBeLessThanMinimumSize, so under 3MB use add-mail-attachment instead. Body: { AttachmentItem: { attachmentType: 'file', name: 'report.pdf', size: 5000000 } }. Returns a pre-authenticated uploadUrl; the caller PUTs the bytes there itself in ranges up to 4MB. This server does not perform the PUT.

Inputs: body (required), messageId (required), confirm, includeHeaders, +1 more.

create-mail-child-foldercreate-mail-child-folderA
Destructive

Use this API to create a new child mailFolder. If you intend a new folder to be hidden, you must set the isHidden property to true on creation.

💡 TIP: Creates a subfolder inside an existing mail folder. Use list-mail-folders or list-mail-child-folders to find the parent folder ID.

Inputs: body (required), mailFolderId (required), confirm, includeHeaders, +1 more.

create-mail-foldercreate-mail-folderA
Destructive

Use this API to create a new mail folder in the root folder of the user's mailbox. If you intend a new folder to be hidden, you must set the isHidden property to true on creation.

💡 TIP: Creates a top-level mail folder. Use create-mail-child-folder to create a subfolder inside an existing folder. Use list-mail-folders to find existing folder IDs.

Inputs: body (required), confirm, includeHeaders, excludeResponse.

create-mail-rulecreate-mail-ruleA
Destructive

Create a messageRule object by specifying a set of conditions and actions. Outlook carries out those actions if an incoming message in the user's Inbox meets the specified conditions.

💡 TIP: Creates a message rule for a mail folder. Use the Inbox folder ID (get it from list-mail-folders) for inbox rules. Body: { displayName: 'Rule name', sequence: 1, isEnabled: true, conditions: { fromAddresses: [{ emailAddress: { address: 'user@example.com' } }] }, actions: { moveToFolder: 'folder-id' } }. Actions: moveToFolder, copyToFolder, forwardTo, forwardAsAttachmentTo, delete, markAsRead, markImportance, stopProcessingRules.

Inputs: body (required), mailFolderId (required), confirm, includeHeaders, +1 more.

create-my-calendar-permissioncreate-my-calendar-permissionA
Destructive

Create a calendarPermission resource to specify the identity and role of the user with whom the specified calendar is being shared or delegated.

💡 TIP: Shares the user's primary calendar with another user (or sets up a delegate). Body: { emailAddress: { name: 'Adele Vance', address: 'adele@contoso.com' }, role: 'read' | 'write' | 'delegateWithoutPrivateEventAccess' | 'delegateWithPrivateEventAccess', isInsideOrganization: true, isRemovable: true }. Use list-users to resolve the recipient SMTP. Returns the created calendarPermission with its id (used by update-my-calendar-permission and delete-my-calendar-permission).

Inputs: body (required), confirm, includeHeaders, excludeResponse.

create-onedrive-foldercreate-onedrive-folderA
Destructive

Create a OneDrive folder.

💡 TIP: Creates a new folder inside the specified drive item. Body must include name (string) and folder ({}) fields. Use @microsoft.graph.conflictBehavior to control behavior on name conflict: 'rename' (default), 'replace', or 'fail'.

Inputs: body (required), driveId (required), driveItemId (required), confirm, +2 more.

create-onenote-notebookcreate-onenote-notebookB
Destructive

Create a new OneNote notebook.

💡 TIP: Creates a new OneNote notebook. Body: { displayName: 'Notebook Name' }. The name must be unique across the user's notebooks.

Inputs: body (required), confirm, includeHeaders, excludeResponse.

create-onenote-pagecreate-onenote-pageA
Destructive

Create a new OneNote page in the default section of the default notebook. To create a page in a different section in the default notebook, you can use the sectionName query parameter. Example: ../onenote/pages?sectionName=My%20section The POST /onenote/pages operation is used only to create pages in the current user's default notebook. If you're targeting other notebooks, you can create pages in a specified section.

💡 TIP: Body must be a full HTML document (with ......). Partial HTML or plain text fails silently or creates malformed pages.

Inputs: body (required), confirm, includeHeaders, excludeResponse.

create-onenote-sectioncreate-onenote-sectionA
Destructive

Create a new onenoteSection in the specified notebook.

💡 TIP: Creates a new section in a notebook. Body: { displayName: 'Section Name' }.

Inputs: body (required), notebookId (required), confirm, includeHeaders, +1 more.

create-onenote-section-pagecreate-onenote-section-pageB
Destructive

Create a new page in the specified section.

💡 TIP: Body must be a full HTML document (with ......). Partial HTML fails silently.

Inputs: body (required), onenoteSectionId (required), confirm, includeHeaders, +1 more.

create-outlook-categorycreate-outlook-categoryA
Destructive

Create an outlookCategory object in the user's master list of categories.

💡 TIP: Creates a new Outlook category. Body: { displayName (unique), color (one of: none, preset0 … preset24 — maps to red, orange, yellow, green, teal, olive, blue, purple, cranberry, steel, dark-steel, gray, dark-gray, black, dark-red, dark-orange, dark-yellow, dark-green, dark-teal, dark-olive, dark-blue, dark-purple, dark-cranberry) }. Category names are case-sensitive when applied to messages/events.

Inputs: body (required), confirm, includeHeaders, excludeResponse.

create-outlook-contactcreate-outlook-contactB
Destructive

Add a contact to the root Contacts folder or to the contacts endpoint of another contact folder.

Inputs: body (required), confirm, includeHeaders, excludeResponse.

create-planner-bucketcreate-planner-bucketC
Destructive

Create a new plannerBucket object.

Inputs: body (required), confirm, includeHeaders, excludeResponse.

create-planner-taskcreate-planner-taskC
Destructive

Create a new plannerTask.

Inputs: body (required), confirm, includeHeaders, excludeResponse.

create-planner-task-messagecreate-planner-task-messageA
Destructive

[beta] Create a new plannerTaskChatMessage on a plannerTask.

💡 TIP: Posts a message to a Planner task's chat (the modern 'task chat', not the legacy conversationThreadId comment). Microsoft is retiring the classic task comments experience and hiding it from the task (Planner 2026 update), so task chat is the current supported way to post per-task updates teammates will see, with @mentions. Body: { content: 'plain text or sanitized HTML', mentions?: [{ mentioned: 'user-id', position: 0, mentionType: 'user' }] } (mentions optional). No ETag/If-Match required. BETA Graph API: subject to change; delegated work/school accounts only — no application permissions, no personal Microsoft accounts, global cloud only (not GCC/DoD/21Vianet).

Inputs: body (required), plannerTaskId (required), confirm, includeHeaders, +1 more.

create-reply-all-draftcreate-reply-all-draftA
Destructive

Create a draft to reply to the sender and all recipients of a message in either JSON or MIME format. When using JSON format:

  • Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.

  • If the original message specifies a recipient in the replyTo property, per Internet Message Format (RFC 2822), you should send the reply to the recipients in the replyTo and toRecipients properties, and not the recipients in the from and toRecipients properties.

  • You can update the draft later to add reply content to the body or change other message properties. When using MIME format:

  • Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.

  • Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, reply-all to a message in a single action.

💡 TIP: For HTML replies pass Message.body.contentType: 'html' with Message.body.content as HTML. Note: supplying Message.body replaces the whole draft body, so the original quoted history is not included. Specifying both 'comment' and Message.body returns 400. Signatures are added by the Outlook client only, not via Graph.

Inputs: body (required), messageId (required), confirm, includeHeaders, +1 more.

create-reply-draftcreate-reply-draftA
Destructive

Create a draft to reply to the sender of a message in either JSON or MIME format. When using JSON format:

  • Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.

  • If replyTo is specified in the original message, per Internet Message Format (RFC 2822), you should send the reply to the recipients in replyTo, and not the recipients in from.

  • You can update the draft later to add reply content to the body or change other message properties. When using MIME format:

  • Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.

  • Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, reply to a message in a single operation.

💡 TIP: For HTML replies pass Message.body.contentType: 'html' with Message.body.content as HTML. Note: supplying Message.body replaces the whole draft body, so the original quoted history is not included. Specifying both 'comment' and Message.body returns 400. Signatures are added by the Outlook client only, not via Graph.

Inputs: body (required), messageId (required), confirm, includeHeaders, +1 more.

create-specific-calendar-eventcreate-specific-calendar-eventC
Destructive

Use this API to create a new event in a calendar. The calendar can be one for a user, or the default calendar of a Microsoft 365 group.

💡 TIP: CRITICAL: Do not try to guess the email address of the recipients. Use the list-users tool to find the email address of the recipients.

Inputs: body (required), calendarId (required), confirm, includeHeaders, +1 more.

create-subscriptioncreate-subscriptionA
Destructive

Subscribes a listener application to receive change notifications when the requested type of changes occur to the specified resource in Microsoft Graph. To identify the resources for which you can create subscriptions and the limitations on subscriptions, see Set up notifications for changes in resource data: Supported resources. Some resources support rich notifications, that is, notifications that include resource data. For more information about these resources, see Set up change notifications that include resource data: Supported resources.

💡 TIP: Creates a webhook subscription for change notifications. Required body: { changeType (comma-separated: 'created,updated,deleted'), notificationUrl (HTTPS, must validate with token echo), resource (e.g. '/me/mailFolders/inbox/messages', '/users/{id}/events', '/teams/{id}/channels/{id}/messages'), expirationDateTime (ISO 8601, max varies by resource type — 1 hour for calls, 24h for messages, 3 days for mail), clientState (opaque string returned in notifications, for validation) }. Optional: includeResourceData (true enables rich notifications, requires encryptionCertificate + encryptionCertificateId). No dedicated scope — caller must have a read permission for the target resource (e.g. Mail.Read, Calendars.Read, ChannelMessage.Read.All, Files.Read.All).

Inputs: body (required), confirm, includeHeaders, excludeResponse.

create-todo-linked-resourcecreate-todo-linked-resourceA
Destructive

Create a linkedResource object to associate a specified task with an item in a partner application. For example, you can associate a task with an email item in Outlook that spurred the task, and you can create a linkedResource object to track its association. You can also create a linkedResource object while creating a task.

💡 TIP: Links a resource to a To Do task. Body: { webUrl: 'https://...', applicationName: 'Mail', displayName: 'Related email', externalId: 'optional-id' }. Use to link tasks to emails, files, or web pages for context.

Inputs: body (required), todoTaskId (required), todoTaskListId (required), confirm, +2 more.

create-todo-taskcreate-todo-taskA
Destructive

Create a new task object in a specified todoTaskList.

💡 TIP: Creates a new task in a Microsoft To Do list. Body: { title: "..." }; optional dueDateTime, reminderDateTime, importance, body (notes), recurrence, categories. Requires todoTaskListId from list-todo-task-lists.

Inputs: body (required), todoTaskListId (required), confirm, includeHeaders, +1 more.

create-todo-task-listcreate-todo-task-listA
Destructive

Create a new lists object.

💡 TIP: Creates a new Microsoft To Do task list (the named buckets shown in the To Do app sidebar). Body: { displayName: 'My new list' }. Returns the created todoTaskList with its id, displayName, isOwner, isShared, and wellknownListName ('none' for user-created lists). The built-in lists ('Tasks', 'Flagged emails') already exist and cannot be re-created. Pair with create-todo-task to populate it.

Inputs: body (required), confirm, includeHeaders, excludeResponse.

create-upload-sessioncreate-upload-sessionA
Destructive

Create an upload session.

💡 TIP: For large file uploads (no size limit, and no minimum unlike the Outlook attachment session). Returns a pre-authenticated uploadUrl; the caller PUTs the bytes there itself. This server does not perform the PUT. For new files use path: /items/{parentId}:/{fileName}:/createUploadSession. Body (optional): { item: { '@microsoft.graph.conflictBehavior': 'rename' } }.

Inputs: body (required), driveId (required), driveItemId (required), confirm, +2 more.

decline-calendar-eventdecline-calendar-eventA
Destructive

Decline invitation to the specified event in a user calendar. If the event allows proposals for new times, on declining the event, an invitee can choose to suggest an alternative time by including the proposedNewTime parameter. For more information on how to propose a time, and how to receive and accept a new time proposal, see Propose new meeting times.

💡 TIP: Declines a meeting invitation. Optional body: { sendResponse: true, comment: 'Cannot attend, conflict.' }. The event remains in the calendar as declined unless the user deletes it.

Inputs: body (required), eventId (required), confirm, includeHeaders, +1 more.

delete-calendardelete-calendarA
Destructive

Delete a calendar other than the default calendar.

💡 TIP: Deletes a calendar and all its events. The default calendar cannot be deleted. This action cannot be undone.

Inputs: calendarId (required), confirm, If-Match, includeHeaders, +1 more.

delete-calendar-eventdelete-calendar-eventA
Destructive

Removes the specified event from the containing calendar. If the event is a meeting, deleting the event on the organizer's calendar sends a cancellation message to the meeting attendees.

💡 TIP: Deleting a seriesMaster deletes ALL occurrences of the recurring event. To cancel a single occurrence, delete that specific instance ID from list-calendar-event-instances.

Inputs: eventId (required), confirm, If-Match, includeHeaders, +1 more.

delete-contact-folderdelete-contact-folderA
Destructive

Delete contactFolder other than the default contactFolder.

💡 TIP: Deletes a contact folder. The default 'Contacts' folder cannot be deleted — Graph returns an error. The folder (and its contents) typically lands in Deleted Items rather than being permanently removed. Get the folder id via list-contact-folders.

Inputs: contactFolderId (required), confirm, If-Match, includeHeaders, +1 more.

delete-drive-item-permissiondelete-drive-item-permissionA
Destructive

Delete a drive item permission.

💡 TIP: Removes a specific permission from a file or folder. Only permissions that are not inherited can be deleted. Use list-drive-item-permissions first to find the permission ID.

Inputs: driveId (required), driveItemId (required), permissionId (required), confirm, +3 more.

delete-excel-rangedelete-excel-rangeA
Destructive

Delete an Excel range.

💡 TIP: Delete cells at the given range, shifting remaining content. Body: { shift: 'Up' } or { shift: 'Left' }. Use 'Up' to delete entire rows.

Inputs: body (required), address (required), driveId (required), driveItemId (required), +4 more.

delete-excel-table-rowdelete-excel-table-rowA
Destructive

Delete an Excel table row.

💡 TIP: Delete a single row from a formal Excel table by zero-based row index.

Inputs: index (required), driveId (required), driveItemId (required), workbookTableId (required), +3 more.

delete-focused-inbox-overridedelete-focused-inbox-overrideA
Destructive

Delete an override specified by its ID.

💡 TIP: Deletes a Focused Inbox override. Future messages from that sender revert to the Outlook ML classifier's default behavior. Use list-focused-inbox-overrides to find the ID first.

Inputs: inferenceClassificationOverrideId (required), confirm, If-Match, includeHeaders, +1 more.

delete-mail-attachmentdelete-mail-attachmentB
Destructive

Delete a mail attachment.

Inputs: messageId (required), attachmentId (required), confirm, If-Match, +2 more.

delete-mail-folderdelete-mail-folderA
Destructive

Delete the specified mailFolder. The folder can be a mailSearchFolder. You can specify a mail folder by its folder ID, or by its well-known folder name, if one exists.

💡 TIP: Deletes a mail folder and all its contents. This action is irreversible. Use list-mail-folders to find the folder ID.

Inputs: mailFolderId (required), confirm, If-Match, includeHeaders, +1 more.

delete-mail-messagedelete-mail-messageA
Destructive

Delete an Outlook email message by its message ID. This is a soft delete that moves the message to Deleted Items.

💡 TIP: Soft delete — moves to Deleted Items. To permanently delete, delete again from Deleted Items.

Inputs: messageId (required), confirm, If-Match, includeHeaders, +1 more.

delete-mail-ruledelete-mail-ruleA
Destructive

Delete the specified messageRule object.

💡 TIP: Deletes a message rule permanently. Use the Inbox folder ID (get it from list-mail-folders) for inbox rules.

Inputs: mailFolderId (required), messageRuleId (required), confirm, If-Match, +2 more.

delete-my-calendar-permissiondelete-my-calendar-permissionA
Destructive

Delete my calendar permission.

💡 TIP: Revokes a calendar share or delegate access. Get the permission id via list-my-calendar-permissions. Permissions where isRemovable=false (e.g. the implicit 'My Organization' default) cannot be deleted — Graph returns an error.

Inputs: calendarPermissionId (required), confirm, If-Match, includeHeaders, +1 more.

delete-onedrive-filedelete-onedrive-fileA
Destructive

Delete a OneDrive file.

Inputs: driveId (required), driveItemId (required), confirm, If-Match, +2 more.

delete-onenote-pagedelete-onenote-pageA
Destructive

Delete a OneNote page.

💡 TIP: Deletes a OneNote page permanently. This cannot be undone.

Inputs: onenotePageId (required), confirm, If-Match, includeHeaders, +1 more.

delete-outlook-contactdelete-outlook-contactB
Destructive

Delete a contact.

Inputs: contactId (required), confirm, If-Match, includeHeaders, +1 more.

delete-planner-bucketdelete-planner-bucketA
Destructive

Delete plannerBucket.

💡 TIP: CRITICAL: Requires If-Match header with ETag from get-planner-bucket (use includeHeaders=true).

Inputs: plannerBucketId (required), confirm, If-Match, includeHeaders, +1 more.

delete-planner-task-messagedelete-planner-task-messageA
Destructive

[beta] Delete a plannerTaskChatMessage object.

💡 TIP: Deletes a message from a Planner task's chat. No request body; If-Match is optional if you want conditional deletion; returns 204. BETA Graph API: subject to change; delegated work/school accounts only — no application permissions, no personal Microsoft accounts, global cloud only (not GCC/DoD/21Vianet).

Inputs: plannerTaskId (required), plannerTaskChatMessageId (required), confirm, If-Match, +2 more.

delete-specific-calendar-eventdelete-specific-calendar-eventA
Destructive

Delete a specific calendar event.

💡 TIP: Deleting a seriesMaster deletes ALL occurrences. To cancel a single occurrence, use the specific instance ID.

Inputs: eventId (required), calendarId (required), confirm, If-Match, +2 more.

delete-subscriptiondelete-subscriptionA
Destructive

Delete a subscription. For the list of resources that support subscribing to change notifications, see the table in the Permissions section.

💡 TIP: Deletes a webhook subscription. No further change notifications will be sent. Use this to clean up stale subscriptions or stop receiving notifications. Use list-subscriptions to find the id.

Inputs: subscriptionId (required), confirm, If-Match, includeHeaders, +1 more.

delete-todo-linked-resourcedelete-todo-linked-resourceC
Destructive

Delete a linkedResource object.

💡 TIP: Removes a linked resource from a To Do task.

Inputs: todoTaskId (required), todoTaskListId (required), linkedResourceId (required), confirm, +3 more.

delete-todo-taskdelete-todo-taskC
Destructive

Delete a todoTask object.

Inputs: todoTaskId (required), todoTaskListId (required), confirm, If-Match, +2 more.

delete-todo-task-listdelete-todo-task-listA
Destructive

Deletes a todoTaskList object.

💡 TIP: Deletes a Microsoft To Do task list. Built-in lists (Flagged emails, the default Tasks list) cannot be deleted — the API returns an error for those. Get list ids via list-todo-task-lists.

Inputs: todoTaskListId (required), confirm, If-Match, includeHeaders, +1 more.

dismiss-calendar-event-reminderdismiss-calendar-event-reminderA
Destructive

Dismiss a reminder that has been triggered for an event in a user calendar.

💡 TIP: Dismisses a triggered event reminder so it won't re-fire. No request body required. Pair with list-calendar-events or get-schedule to find active reminders.

Inputs: eventId (required), confirm, includeHeaders, excludeResponse.

download-bytesA
Read-only

Download binary content from Microsoft Graph and return it as base64. Single tool for any binary read: drive file content, mail attachment, profile photo, Teams hosted content, meeting recording. Returns { contentType, encoding: "base64", contentLength, contentBytes }. For large drive/SharePoint file content, prefer get-download-url, which returns a pre-authenticated URL to stream bytes out-of-band instead of base64 through the agent context.

Inputs: target (required).

download-bytes-to-fileA
Read-only

Write authenticated Microsoft Graph byte content to a local file on the server, returning { path, contentType, bytesWritten } instead of base64. The only out-of-band way to save mail attachments and meeting recordings, whose bytes are exposed solely through authenticated endpoints. Also handles profile photos and Teams hosted content. Writes to an absolute outputPath and never overwrites an existing file. stdio mode only: not available over HTTP. For OneDrive or SharePoint file content, get-download-url is preferred — it returns a pre-authenticated URL for fully out-of-band download without the server fetching the bytes.

Inputs: target (required), outputPath (required).

format-excel-rangeformat-excel-rangeA
Destructive

Format an Excel range.

💡 TIP: Apply rangeFormat properties to a specific range. Required path param 'address' (e.g. 'A1:E5' or 'Sheet1!A1:E5'). Body: { horizontalAlignment, verticalAlignment, wrapText, columnWidth, rowHeight }. Font, fill, and borders are NOT set here; use format-excel-range-font, format-excel-range-fill, and format-excel-range-border for those.

Inputs: body (required), address (required), driveId (required), driveItemId (required), +4 more.

format-excel-range-borderformat-excel-range-borderA
Destructive

Format an Excel range border.

💡 TIP: Sets one border side. The {sideIndex} path param selects which side: EdgeTop, EdgeBottom, EdgeLeft, EdgeRight, InsideVertical, InsideHorizontal, DiagonalDown, or DiagonalUp. To outline all four edges, call once per side.

Inputs: body (required), address (required), driveId (required), sideIndex (required), +5 more.

format-excel-range-fillformat-excel-range-fillC
Destructive

Format an Excel range fill.

💡 TIP: Set the background fill color of a range's cells.

Inputs: body (required), address (required), driveId (required), driveItemId (required), +4 more.

format-excel-range-fontformat-excel-range-fontB
Destructive

Format an Excel range font.

💡 TIP: Set font formatting on a range: bold, italic, underline, size, color, and font name.

Inputs: body (required), address (required), driveId (required), driveItemId (required), +4 more.

forward-calendar-eventforward-calendar-eventA
Destructive

This action allows the organizer or attendee of a meeting event to forward the meeting request to a new recipient. If the meeting event is forwarded from an attendee's Microsoft 365 mailbox to another recipient, this action also sends a message to notify the organizer of the forwarding, and adds the recipient to the organizer's copy of the meeting event. This convenience is not available when forwarding from an Outlook.com account.

💡 TIP: Forwards a meeting invitation to additional recipients. Body: { ToRecipients: [{ emailAddress: { address, name } }], Comment (optional) }. If the forwarder is an attendee (not organizer), the organizer is also notified and the new recipient is added to the organizer's attendee list.

Inputs: body (required), eventId (required), confirm, includeHeaders, +1 more.

forward-mail-messageforward-mail-messageA
Destructive

Forward a message using either JSON or MIME format. When using JSON format, you can:

  • Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.

  • Specify either the toRecipients parameter or the toRecipients property of the message parameter. Specifying both or specifying neither will return an HTTP 400 Bad Request error. When using MIME format:

  • Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.

  • Add any attachments and S/MIME properties to the MIME content. This method saves the message in the Sent Items folder. Alternatively, create a draft to forward a message, and send it later.

💡 TIP: Forward an email preserving full HTML formatting and attachments. The 'comment' field adds text above the forwarded content. toRecipients is required. Do NOT reconstruct the email manually - this endpoint handles everything server-side.

Inputs: body (required), messageId (required), confirm, includeHeaders, +1 more.

get-calendar-eventget-calendar-eventB
Read-only

Get the properties and relationships of the specified event object. Currently, this operation returns event bodies in only HTML format. There are two scenarios where an app can get an event in another user's calendar: Since the event resource supports extensions, you can also use the GET operation to get custom properties and extension data in an event instance.

Inputs: eventId (required), expand, select, timezone, +4 more.

get-calendar-viewget-calendar-viewA
Read-only

Get the occurrences, exceptions, and single instances of events in a calendar view defined by a time range, from the user's default calendar, or from some other calendar of the user.

💡 TIP: Returns expanded recurring event instances (not just seriesMaster) within a date range for the default calendar. Requires startDateTime and endDateTime query parameters in ISO 8601 format (e.g., 2024-01-01T00:00:00Z). Use get-specific-calendar-view if you need a non-default calendar. To find Teams meetings, use $filter=isOnlineMeeting eq true. To search by subject, use $filter=contains(subject,'keyword'). Teams meetings include a joinWebUrl property needed for transcript access via list-online-meetings.

Inputs: endDateTime (required), startDateTime (required), top, skip, +11 more.

get-current-userget-current-userA
Read-only

Retrieve the properties and relationships of user object. This operation returns by default only a subset of the more commonly used properties for each user. These default properties are noted in the Properties section. To get properties that are not returned by default, do a GET operation for the user and specify the properties in a $select OData query option. Because the user resource supports extensions, you can also use the GET operation to get custom properties and extension data in a user instance. Customers through Microsoft Entra ID for customers can also use this API operation to retrieve their details.

Inputs: expand, select, fetchAllPages, includeHeaders, +2 more.

get-download-urlA
Read-only

Resolve a short-lived, pre-authenticated download URL for Microsoft Graph binary content that exposes one (drive/SharePoint file content). The returned URL streams the bytes with NO Authorization header, so the client can fetch it straight to disk (e.g. curl) without round-tripping base64 through the agent context. Prefer this over download-bytes for any file above a few KB or any bulk download. Returns { downloadUrl, name?, size?, contentType? }. NOTE: mail file attachments (/messages/{id}/attachments/{id}/$value) and meeting recordings do NOT expose a pre-authenticated URL — Graph offers no such link for them; use download-bytes for small ones.

Inputs: target (required).

get-drive-deltaget-drive-deltaA
Read-only

Track changes in a driveItem and its children over time. Your app begins by calling delta without any parameters. The service starts enumerating the drive's hierarchy, returning pages of items and either an @odata.nextLink or an @odata.deltaLink, as described below. Your app should continue calling with the @odata.nextLink until you no longer see an @odata.nextLink returned, or you see a response with an empty set of changes. After you have finished receiving all the changes, you may apply them to your local state. To check for changes in the future, call delta again with the @odata.deltaLink from the previous response. Deleted items are returned with the deleted facet. Items with this property set should be removed from your local state.

💡 TIP: Tracks changes to a driveItem and its children over time. Returns a collection of driveItems that have been created, modified, or deleted. Use get-drive-root-item first to get the root driveItem-id, then pass it here. Supports $select and delta tokens for incremental sync via @odata.deltaLink.

Inputs: driveId (required), driveItemId (required), top, skip, +9 more.

get-drive-itemget-drive-itemB
Read-only

All items contained in the drive. Read-only. Nullable.

💡 TIP: Gets metadata for a file or folder: name, size, lastModifiedDateTime, createdBy, webUrl, file (mimeType, hashes), folder (childCount), parentReference, and @microsoft.graph.downloadUrl. For large drive/SharePoint files, call get-download-url with target=/drives/{drive-id}/items/{driveItem-id}/content to fetch out-of-band with no Authorization header. For small files where base64 in the tool response is acceptable, call download-bytes with the same /content target.

Inputs: driveId (required), driveItemId (required), expand, select, +3 more.

get-drive-root-itemget-drive-root-itemD
Read-only

The root folder of the drive. Read-only.

Inputs: driveId (required), expand, select, fetchAllPages, +2 more.

get-excel-rangeget-excel-rangeC
Read-only

Get an Excel range.

Inputs: address (required), driveId (required), driveItemId (required), workbookWorksheetId (required), +3 more.

get-excel-range-formatget-excel-range-formatA
Read-only

Returns a format object, encapsulating the range's font, fill, borders, alignment, and other properties. Read-only.

💡 TIP: Reads a range's format: alignment, wrapText, columnWidth, rowHeight. Font, fill, and borders are nested and omitted by default; add font, fill, and borders to the $expand parameter to include them in one call. Cell styling often encodes meaning (a fill or font color flagging status such as tentative or reconciled), so expand these to interpret what the cells mean.

Inputs: address (required), driveId (required), driveItemId (required), workbookWorksheetId (required), +5 more.

get-excel-tableget-excel-tableB
Read-only

Represents a collection of tables associated with the workbook. Read-only.

💡 TIP: Gets a specific table by name or ID. Returns table properties including columns, showHeaders, showTotals, and style.

Inputs: driveId (required), driveItemId (required), workbookTableId (required), expand, +4 more.

get-excel-used-rangeget-excel-used-rangeA
Read-only

Get an Excel used range.

💡 TIP: Get the smallest range that encompasses any cells with values or formatting on the worksheet. Returns address, values, formulas, numberFormat, rowCount, columnCount. Use this to discover the populated bounds of a sheet before reading or appending — avoids guessing how far data extends. Optional $select to trim the response.

Inputs: driveId (required), driveItemId (required), workbookWorksheetId (required), fetchAllPages, +2 more.

get-mailbox-settingsget-mailbox-settingsA
Read-only

Get the user's mailboxSettings. You can view all mailbox settings, or get specific settings. Users can set the following settings for their mailboxes through an Outlook client: Users can set their preferred date and time formats using Outlook on the web. Users can choose one of the supported short date or short time formats. This GET operation returns the format the user has chosen. Users can set the time zone they prefer on any Outlook client, by choosing from the supported time zones that their administrator has set up for their mailbox server. The administrator can set up time zones in the Windows time zone format or Internet Assigned Numbers Authority (IANA) time zone (also known as Olson time zone) format. The Windows format is the default. This GET operation returns the user's preferred time zone in the format that the administrator has set up. If you want that time zone to be in a specific format (Windows or IANA), you can first update the preferred time zone in that format as a mailbox setting. Subsequently you will be able to get the time zone in that format. Alternatively, you can manage the format conversion separately in your app.

💡 TIP: Gets the current user's mailbox settings including automaticRepliesSetting (out-of-office status, message, scheduledStartDateTime/EndDateTime, externalAudience), language, timeZone, dateFormat, timeFormat, delegateMeetingMessageDeliveryOptions, and userPurpose.

Inputs: expand, select, fetchAllPages, includeHeaders, +1 more.

get-mail-messageget-mail-messageA
Read-only

Get a single Outlook email message by its message ID, including full subject, sender, recipients, body, and attachment flags. Use list-mail-messages first to obtain the message ID.

Inputs: messageId (required), expand, select, fetchAllPages, +2 more.

get-mail-message-mimeget-mail-message-mimeA
Read-only

Download the raw MIME source (RFC 822 .eml content) of an Outlook email message by its message ID. Returns the complete original message including headers and encoded attachments.

💡 TIP: Download an email message as raw RFC 5322 MIME content (.eml format). Use this when archiving an email to disk preserving all original headers, body, and inline-encoded attachments. Returns the MIME stream as text. Find the message id with list-mail-messages first.

Inputs: messageId (required), fetchAllPages, includeHeaders, excludeResponse, +1 more.

get-mail-tipsget-mail-tipsA
Read-only

Get the MailTips of one or more recipients as available to the signed-in user. Note that by making a POST call to the getMailTips action, you can request specific types of MailTips to be returned for more than one recipient at one time. The requested MailTips are returned in a mailTips collection.

💡 TIP: Looks up MailTips for one or more recipients before sending an email — answers 'is this person on auto-reply / OOF?', 'will my email exceed their mailbox quota?', 'are they an external recipient?', 'is this a mailbox or distribution list?'. Body: { EmailAddresses: ['user@contoso.com', ...], MailTipsOptions: 'automaticReplies, mailboxFullStatus, customMailTip, externalMemberCount, totalMemberCount, maxMessageSize, deliveryRestriction, moderationStatus, recipientScope, recipientSuggestions' (comma-separated subset) }. Returns mailTips per recipient with the requested fields populated. Use this to short-circuit urgent emails when a recipient is OOF, or to warn before fanning out to a large DL.

Inputs: body (required), includeHeaders, excludeResponse.

get-my-profileget-my-profileA
Read-only

[beta] Retrieve the properties and relationships of a profile object for a given user. The profile resource exposes various rich properties that are descriptive of the user as relationships, for example, anniversaries and education activities. To get one of these navigation properties, use the corresponding GET method on that property. See the methods exposed by profile.

💡 TIP: Retrieves the signed-in user's rich profile - a richer object than get-current-user, exposing relationships like skills, projects, languages, education and work positions. Use $expand to pull related collections (e.g. $expand=skills,projects).

Inputs: expand, select, fetchAllPages, includeHeaders, +1 more.

get-onenote-page-contentget-onenote-page-contentD
Read-only

The page's HTML content.

Inputs: onenotePageId (required), fetchAllPages, includeHeaders, excludeResponse.

get-outlook-contactget-outlook-contactC
Read-only

Retrieve the properties and relationships of a contact object. There are two scenarios where an app can get a contact in another user's contact folder:

Inputs: contactId (required), expand, select, fetchAllPages, +2 more.

get-planner-bucketget-planner-bucketA
Read-only

Retrieve the properties and relationships of a plannerBucket object.

💡 TIP: Response includes @odata.etag — required as If-Match for update-planner-bucket and delete-planner-bucket. Use includeHeaders=true.

Inputs: plannerBucketId (required), expand, select, fetchAllPages, +2 more.

get-planner-planget-planner-planB
Read-only

Retrieve the properties and relationships of a plannerplan object.

Inputs: plannerPlanId (required), expand, select, fetchAllPages, +2 more.

get-planner-taskget-planner-taskA
Read-only

Retrieve the properties and relationships of plannerTask object.

💡 TIP: Response includes @odata.etag — save it, required as If-Match header for update-planner-task. Use includeHeaders=true to capture it.

Inputs: plannerTaskId (required), expand, select, fetchAllPages, +2 more.

get-planner-task-detailsget-planner-task-detailsA
Read-only

Retrieve the properties and relationships of a plannerTaskDetails object.

💡 TIP: Response includes @odata.etag — required for update-planner-task-details. Use includeHeaders=true.

Inputs: plannerTaskId (required), expand, select, fetchAllPages, +2 more.

get-specific-calendar-eventget-specific-calendar-eventA
Read-only

Get a single event from one of the signed-in user's calendars, addressed by calendar ID and event ID. Any calendar can be addressed this way, including the default one.

Inputs: eventId (required), calendarId (required), expand, select, +5 more.

get-specific-calendar-viewget-specific-calendar-viewA
Read-only

List the occurrences, exceptions, and single instances of events over a time range, from one of the signed-in user's calendars addressed by calendar ID.

💡 TIP: Returns expanded recurring event instances (not just seriesMaster) within a date range for a specific calendar. Requires startDateTime and endDateTime query parameters in ISO 8601 format (e.g., 2024-01-01T00:00:00Z). Each instance includes seriesMasterId and type (occurrence/exception) fields for recurring event linkage. Use fetchAllPages=true to retrieve all results when there are many events. To find Teams meetings, use $filter=isOnlineMeeting eq true. Teams meetings include a joinWebUrl property needed for transcript access via list-online-meetings.

Inputs: calendarId (required), endDateTime (required), startDateTime (required), top, +12 more.

get-subscriptionget-subscriptionA
Read-only

Retrieve the properties and relationships of a subscription. See the table in the Permissions section for the list of resources that support subscribing to change notifications.

💡 TIP: Gets a specific webhook subscription by id. Use list-subscriptions to find the id. Returns full subscription details including resource, changeType, notificationUrl, expirationDateTime, applicationId.

Inputs: subscriptionId (required), select, fetchAllPages, includeHeaders, +1 more.

get-todo-taskget-todo-taskA
Read-only

Read the properties and relationships of a todoTask object.

💡 TIP: Returns a single To Do task. NOTE: $select is NOT supported — do not pass select parameter, Graph returns RequestBroker--ParseUri (400). Use $expand=linkedResources to include linked email/resource. Returns body content (HTML format), checklist items, and linked resources.

Inputs: todoTaskId (required), todoTaskListId (required), expand, select, +3 more.

graph-batchgraph-batchA
Destructive

Combine up to 20 Graph requests into a single HTTP call. Body: { requests: [{ id: '1', method: 'GET'|'POST'|'PATCH'|'DELETE', url: '/me/messages?$top=5', headers?: {...}, body?: {...}, dependsOn?: ['1'] }, ...] }. Returns { responses: [{ id, status, body, headers }] } in arbitrary order — match by id. Use cases: (1) parallelize many small reads (e.g. fetch 15 mail messages by id in one round-trip); (2) sequence dependent writes via dependsOn; (3) batch many Excel range writes into one call to dramatically reduce latency on large workbook builds. Note: each sub-request URL is relative to the Graph version root (/me/..., /drives/..., NOT https://graph.microsoft.com/v1.0/...).

💡 TIP: Combine up to 20 Graph requests into a single HTTP call. Body: { requests: [{ id: '1', method: 'GET'|'POST'|'PATCH'|'DELETE', url: '/me/messages?$top=5', headers?: {...}, body?: {...}, dependsOn?: ['1'] }, ...] }. Returns { responses: [{ id, status, body, headers }] } in arbitrary order — match by id. Use cases: (1) parallelize many small reads (e.g. fetch 15 mail messages by id in one round-trip); (2) sequence dependent writes via dependsOn; (3) batch many Excel range writes into one call to dramatically reduce latency on large workbook builds. Note: each sub-request URL is relative to the Graph version root (/me/..., /drives/..., NOT https://graph.microsoft.com/v1.0/...).

Inputs: body (required), confirm, includeHeaders, excludeResponse.

insert-excel-rangeinsert-excel-rangeA
Destructive

Insert an Excel range.

💡 TIP: Insert blank cells at the given range, shifting existing content. Body: { shift: 'Down' } or { shift: 'Right' }. Use 'Down' to insert blank rows above existing data.

Inputs: body (required), address (required), driveId (required), driveItemId (required), +4 more.

list-accountsA
Read-only

List all Microsoft accounts configured in this server. Use this to discover available account emails before making tool calls. Reflects accounts added mid-session via --login.

Inputs: no named parameters.

list-all-onenote-sectionslist-all-onenote-sectionsA
Read-only

Retrieve a list of onenoteSection objects.

💡 TIP: Lists all sections across all notebooks. Use list-onenote-notebook-sections to list sections within a specific notebook instead.

Inputs: top, skip, count, expand, +7 more.

list-calendar-event-instanceslist-calendar-event-instancesA
Read-only

The occurrences of a recurring series, if the event is a series master. This property includes occurrences that are part of the recurrence pattern, and exceptions modified, but doesn't include occurrences canceled from the series. Navigation property. Read-only. Nullable.

💡 TIP: Expand a recurring event into individual instances within a date range. Requires startDateTime and endDateTime query parameters in ISO 8601 format (e.g., 2024-01-01T00:00:00Z). Use this to see all occurrences of a recurring event.

Inputs: eventId (required), calendarId (required), endDateTime (required), startDateTime (required), +13 more.

list-calendar-eventslist-calendar-eventsA
Read-only

Get a list of event objects in the user's mailbox. The list contains single instance meetings and series masters. To get expanded event instances, you can get the calendar view, or get the instances of an event. Currently, this operation returns event bodies in only HTML format. There are two scenarios where an app can get events in another user's calendar:

💡 TIP: WARNING: Does NOT expand recurring events — only returns seriesMaster. Use get-calendar-view instead to see individual occurrences within a date range.

Inputs: top, skip, count, expand, +9 more.

list-calendar-events-deltalist-calendar-events-deltaA
Read-only

Get a set of event resources that have been added, deleted, or updated in a calendarView (a range of events defined by start and end dates) of the user's primary calendar. Typically, synchronizing events in a calendarView in a local store entails a round of multiple delta function calls. The initial call is a full synchronization, and every subsequent delta call in the same round gets the incremental changes (additions, deletions, or updates). This allows you to maintain and synchronize a local store of events in the specified calendarView, without having to fetch all the events of that calendar from the server every time.

💡 TIP: Incremental sync of events across the default calendar. First call returns all events plus @odata.deltaLink. Subsequent calls with that link return only additions/updates/removals. Use $select to limit fields. Deltas expire after ~30 days — start over if the server returns 410 Gone. For a time-bounded view with delta semantics, use list-calendar-view-delta instead.

Inputs: endDateTime (required), startDateTime (required), skip, count, +8 more.

list-calendarslist-calendarsA
Read-only

Get all the user's calendars (/calendars navigation property), get the calendars from the default calendar group or from a specific calendar group.

Inputs: top, skip, count, expand, +7 more.

list-calendar-view-deltalist-calendar-view-deltaA
Read-only

Get a set of event resources that have been added, deleted, or updated in a calendarView (a range of events defined by start and end dates) of the user's primary calendar. Typically, synchronizing events in a calendarView in a local store entails a round of multiple delta function calls. The initial call is a full synchronization, and every subsequent delta call in the same round gets the incremental changes (additions, deletions, or updates). This allows you to maintain and synchronize a local store of events in the specified calendarView, without having to fetch all the events of that calendar from the server every time.

💡 TIP: Incremental sync of events within a time window. Required query params on first call: startDateTime, endDateTime (ISO 8601). Returns events in the window plus @odata.deltaLink; subsequent calls with that link return only changes. Expands recurring events to individual occurrences (unlike list-calendar-events-delta which returns the series master). Use this for calendar UIs showing a week/month view.

Inputs: endDateTime (required), startDateTime (required), skip, count, +8 more.

list-contact-folder-child-folderslist-contact-folder-child-foldersA
Read-only

Get a collection of child folders under the specified contact folder.

💡 TIP: Lists immediate sub-folders under a given contact folder. Returns id, displayName, parentFolderId. Use list-contact-folders to discover top-level folders, then this tool to traverse one level deeper. Supports $filter, $top, $orderby. Note: contact folders are typically a flat list in Outlook clients, but Graph allows nesting via this endpoint.

Inputs: contactFolderId (required), top, skip, count, +8 more.

list-contact-folder-contactslist-contact-folder-contactsA
Read-only

Get a contact collection from the default Contacts folder of the signed-in user (.../me/contacts), or from the specified contact folder.

💡 TIP: Lists contacts inside a specific folder. Pair with list-contact-folders to discover the folder id. Note: the existing list-outlook-contacts (GET /me/contacts) only returns contacts from the default folder — use this tool to read contacts from any folder. Supports $filter, $search='query', $orderby, $top, $select.

Inputs: contactFolderId (required), top, skip, count, +8 more.

list-contact-folderslist-contact-foldersA
Read-only

Get the contact folder collection in the default Contacts folder of the signed-in user.

💡 TIP: Lists the user's Outlook contact folders (the named buckets that organize contacts). Always includes the built-in 'Contacts' folder; user-created folders also appear. Returns id, displayName, and parentFolderId. To identify the default folder, match displayName === 'Contacts'. Use this before list-contact-folder-contacts or create-contact-in-folder to discover folder ids. Supports OData query parameters.

Inputs: top, skip, count, expand, +7 more.

list-drive-item-permissionslist-drive-item-permissionsC
Read-only

The set of permissions for the item. Read-only. Nullable.

💡 TIP: Lists all permissions (sharing links, direct access, inherited) on a file or folder. Each permission has roles, grantedTo (user), link (sharing URL), and inheritedFrom.

Inputs: driveId (required), driveItemId (required), top, skip, +9 more.

list-drive-item-thumbnailslist-drive-item-thumbnailsA
Read-only

Collection of thumbnailSet objects associated with the item. For more information, see getting thumbnails. Read-only. Nullable.

💡 TIP: Lists thumbnail sets for a file. Each set contains small (96px), medium (176px), large (800px) thumbnails with url and dimensions. Returns empty for unsupported types (text docs). Use $select=small,medium,large or $expand=small($select=url) to fetch specific sizes. The returned URLs are short-lived — fetch the bytes immediately.

Inputs: driveId (required), driveItemId (required), top, skip, +9 more.

list-drive-item-versionslist-drive-item-versionsB
Read-only

The list of previous versions of the item. For more info, see getting previous versions. Read-only. Nullable.

💡 TIP: Lists version history of a file. Each version has id, lastModifiedDateTime, lastModifiedBy, and size. Use the version id with /versions/{id}/content to download a specific version.

Inputs: driveId (required), driveItemId (required), top, skip, +9 more.

list-driveslist-drivesA
Read-only

Retrieve the list of Drive resources available for a target User, Group, or Site.

Inputs: top, skip, count, expand, +7 more.

list-excel-table-rowslist-excel-table-rowsA
Read-only

The list of all the rows in the table. Read-only.

💡 TIP: Lists all rows in a table. Each row has index and values (array of cell values). Use $top and $skip for pagination on large tables.

Inputs: driveId (required), driveItemId (required), workbookTableId (required), top, +10 more.

list-excel-tableslist-excel-tablesA
Read-only

Represents a collection of tables associated with the workbook. Read-only.

💡 TIP: Lists all named tables in a workbook. Each table has id, name, showHeaders, showTotals, columns, and style. Use the table name or id with other table endpoints.

Inputs: driveId (required), driveItemId (required), top, skip, +9 more.

list-excel-worksheetslist-excel-worksheetsD
Read-only

Represents a collection of worksheets associated with the workbook. Read-only.

Inputs: driveId (required), driveItemId (required), top, skip, +9 more.

list-focused-inbox-overrideslist-focused-inbox-overridesA
Read-only

Get the overrides that a user has set up to always classify messages from certain senders in specific ways. Each override corresponds to an SMTP address of a sender. Initially, a user doesn't have any overrides.

💡 TIP: Lists Focused Inbox classification overrides — explicit rules that force messages from a given sender (by SMTP address) into either the Focused or Other tab, regardless of what the Outlook ML classifier would predict. Each override has id, classifyAs ('focused' or 'other'), and senderEmailAddress {name, address}. Returns an empty collection if the user has never set an override.

Inputs: top, skip, count, expand, +7 more.

list-folder-fileslist-folder-filesA
Read-only

Return a collection of DriveItems in the children relationship of a DriveItem. DriveItems with a non-null folder or package facet can have one or more child DriveItems.

Inputs: driveId (required), driveItemId (required), top, skip, +9 more.

list-mail-attachmentslist-mail-attachmentsA
Read-only

Retrieve a list of attachment objects.

💡 TIP: Lists attachments on a message: id, name, contentType, size, isInline. To download the bytes, call download-bytes with target=/me/messages/{message-id}/attachments/{attachment-id}/$value (the /$value suffix returns raw bytes; the bare attachment URL embeds contentBytes in JSON which can truncate large files).

Inputs: messageId (required), top, skip, count, +8 more.

list-mail-child-folderslist-mail-child-foldersA
Read-only

Get the folder collection under the specified folder. You can use the .../me/mailFolders shortcut to get the top-level folder collection and navigate to another folder. By default, this operation doesn't return hidden folders. Use a query parameter includeHiddenFolders to include them in the response.

Inputs: mailFolderId (required), top, skip, count, +9 more.

list-mail-folder-messageslist-mail-folder-messagesA
Read-only

Get all the messages in the specified user's mailbox, or those messages in a specified folder in the mailbox.

💡 TIP: List read search Outlook emails within a specific mail folder. CRITICAL: When searching emails, the $search parameter value MUST be wrapped in double quotes. Format: $search="your search query here". Use KQL (Keyword Query Language) syntax to search specific properties: 'from:', 'subject:', 'body:', 'to:', 'cc:', 'bcc:', 'attachment:', 'hasAttachments:', 'importance:', 'received:', 'sent:'. Examples: $search="from:john@example.com" | $search="subject:meeting AND hasAttachments:true" | $search="body:urgent AND received>=2024-01-01" | $search="from:alice AND importance:high". Remember: ALWAYS wrap the entire search expression in double quotes! Reference: https://learn.microsoft.com/en-us/graph/search-query-parameter IMPORTANT: Always use $select to limit returned fields and reduce response size. Recommended default: $select=id,subject,from,toRecipients,receivedDateTime,bodyPreview,isRead,hasAttachments. Use bodyPreview instead of body for listings. To read the full email body, use get-mail-message with the specific message id.

Inputs: mailFolderId (required), top, skip, count, +8 more.

list-mail-folder-messages-deltalist-mail-folder-messages-deltaA
Read-only

Get a set of messages added, deleted, or updated in a specified folder. A delta function call for messages in a folder is similar to a GET request, except that by appropriately applying state tokens in one or more of these calls, you can query for incremental changes in the messages in that folder. It allows you to maintain and synchronize a local store of a user's messages without having to fetch the entire set of messages from the server every time.

💡 TIP: Incremental sync of messages within a mail folder. Graph only supports delta scoped to a folder — use mailFolder-id = 'inbox' for the well-known inbox, or another folder id from list-mail-folders. First call returns all messages plus @odata.deltaLink; subsequent calls with that link return only changes (created/updated/deleted). @odata.nextLink paginates within a single delta window. Deltas expire after ~30 days of inactivity — start over if the server returns 410. Prefer this over full re-list for polling.

Inputs: mailFolderId (required), top, skip, count, +9 more.

list-mail-folderslist-mail-foldersA
Read-only

Get the mail folder collection directly under the root folder of the signed-in user. The returned collection includes any mail search folders directly under the root. By default, this operation doesn't return hidden folders. Use a query parameter includeHiddenFolders to include them in the response. This operation doesn't return all mail folders in a mailbox, only the child folders of the root folder. To return all mail folders in a mailbox, each child folder must be traversed separately.

Inputs: top, skip, count, expand, +8 more.

list-mail-messageslist-mail-messagesA
Read-only

List, search, and filter Outlook email messages in the signed-in user's mailbox across all folders. Returns message metadata (subject, from, receivedDateTime, isRead, hasAttachments) plus a body preview. Use $search for keyword queries, $filter to narrow by sender/read state/date, $top to limit page size, and $select to trim fields.

💡 TIP: List read search my Outlook emails across folders. CRITICAL: When searching emails, the $search parameter value MUST be wrapped in double quotes. Format: $search="your search query here". Use KQL (Keyword Query Language) syntax to search specific properties: 'from:', 'subject:', 'body:', 'to:', 'cc:', 'bcc:', 'attachment:', 'hasAttachments:', 'importance:', 'received:', 'sent:'. Examples: $search="from:john@example.com" | $search="subject:meeting AND hasAttachments:true" | $search="body:urgent AND received>=2024-01-01" | $search="from:john AND importance:high". Remember: ALWAYS wrap the entire search expression in double quotes! Reference: https://learn.microsoft.com/en-us/graph/search-query-parameter IMPORTANT: Always use $select to limit returned fields and reduce response size. Recommended default: $select=id,subject,from,toRecipients,receivedDateTime,bodyPreview,isRead,hasAttachments. Use bodyPreview instead of body for listings. To read the full email body, use get-mail-message with the specific message id.

Inputs: top, skip, count, expand, +8 more.

list-mail-ruleslist-mail-rulesA
Read-only

Get all the messageRule objects defined for the user's inbox.

💡 TIP: Lists all message rules for a mail folder. Use the Inbox folder ID (get it from list-mail-folders) for inbox rules. Each rule has displayName, sequence, isEnabled, conditions (fromAddresses, subjectContains, etc.), actions (moveToFolder, forwardTo, delete, etc.), and exceptions.

Inputs: mailFolderId (required), top, skip, count, +8 more.

list-my-calendar-permissionslist-my-calendar-permissionsA
Read-only

The permissions of the users with whom the calendar is shared.

💡 TIP: Lists share recipients and delegates on the user's primary calendar. Returns calendarPermission objects with id, role ('none' | 'freeBusyRead' | 'limitedRead' | 'read' | 'write' | 'delegateWithoutPrivateEventAccess' | 'delegateWithPrivateEventAccess' | 'custom'), emailAddress { name, address }, isInsideOrganization, isRemovable, allowedRoles. Returns an empty collection when called by a delegate or share recipient (only the calendar owner sees the full list). For a non-primary calendar, use /me/calendars/{calendar-id}/calendarPermissions — not currently exposed.

Inputs: top, skip, count, expand, +7 more.

list-onenote-notebookslist-onenote-notebooksC
Read-only

Retrieve a list of notebook objects.

Inputs: top, skip, count, expand, +7 more.

list-onenote-notebook-sectionslist-onenote-notebook-sectionsA
Read-only

Retrieve a list of onenoteSection objects from the specified notebook.

Inputs: notebookId (required), top, skip, count, +8 more.

list-onenote-pageslist-onenote-pagesA
Read-only

Retrieve a list of page objects.

💡 TIP: Lists all OneNote pages across every notebook and section the user has access to — transverse alternative to walking notebooks → sections → pages. Default returns top 20 ordered by lastModifiedTime desc. Supports $filter (e.g. lastModifiedTime gt 2026-01-01, or contains(tolower(title), 'topic') for title search), $top (max 100), $select, and $expand=parentNotebook,parentSection. Use this instead of bouncing through list-onenote-notebooks / list-all-onenote-sections / list-onenote-section-pages when you have a topic in mind.

Inputs: top, skip, count, expand, +7 more.

list-onenote-section-groupslist-onenote-section-groupsA
Read-only

Retrieve a list of sectionGroup objects.

💡 TIP: Lists all OneNote section groups (subfolders inside notebooks that contain their own sections and nested section groups) for the user. A section group is a folder-like container — many notebooks use them to organize sections by theme. Default sort is name asc. Supports $expand=sections,sectionGroups,parentNotebook,parentSectionGroup to traverse the full hierarchy. Pair with list-onenote-notebooks for a complete picture of the user's notebook structure.

Inputs: top, skip, count, expand, +7 more.

list-onenote-section-pageslist-onenote-section-pagesC
Read-only

Retrieve a list of page objects from the specified section.

Inputs: onenoteSectionId (required), top, skip, count, +8 more.

list-outlook-categorieslist-outlook-categoriesA
Read-only

Get all the categories that have been defined for a user.

💡 TIP: Lists the user's Outlook categories (colored labels) used to tag messages, events, contacts, and tasks. Each category has displayName and color (preset0 through preset24, or 'none'). Use this to show available tags before applying via update-mail-message or update-calendar-event with body { categories: ['Category Name'] }.

Inputs: top, skip, count, expand, +7 more.

list-outlook-contactslist-outlook-contactsA
Read-only

Get a contact collection from the default contacts folder of the signed-in user. There are two scenarios where an app can get contacts in another user's contact folder:

💡 TIP: $filter only supports startswith() — contains() and eq on emailAddresses do not work. Use $search as alternative for broader matching.

Inputs: top, skip, count, expand, +7 more.

list-plan-bucketslist-plan-bucketsA
Read-only

Retrieve a list of plannerBucket objects contained by a plannerPlan object.

Inputs: plannerPlanId (required), top, skip, count, +8 more.

list-planner-task-messageslist-planner-task-messagesA
Read-only

[beta] Retrieve a list of plannerTaskChatMessage objects associated with a plannerTask.

💡 TIP: Lists messages in a Planner task's chat — the modern Planner 'task chat', distinct from the legacy conversationThreadId comments (which live in the M365 group conversation thread). Each message has id, content (HTML), createdBy, createdDateTime, mentions, reactions. BETA Graph API: subject to change; delegated work/school accounts only — no application permissions, no personal Microsoft accounts, global cloud only (not GCC/DoD/21Vianet).

Inputs: plannerTaskId (required), top, skip, count, +8 more.

list-planner-taskslist-planner-tasksA
Read-only

Retrieve a list of plannertask objects assigned to a User.

💡 TIP: Priority values: 0=Urgent, 1=Important, 3=Medium, 5=Low, 9=unset.

Inputs: top, skip, count, expand, +7 more.

list-plan-taskslist-plan-tasksA
Read-only

Retrieve a list of plannerTask objects associated with a plannerPlan object.

💡 TIP: Priority values: 0=Urgent, 1=Important, 3=Medium, 5=Low, 9=unset.

Inputs: plannerPlanId (required), top, skip, count, +8 more.

list-specific-calendar-eventslist-specific-calendar-eventsA
Read-only

List events from one of the signed-in user's calendars, addressed by calendar ID.

💡 TIP: WARNING: Does NOT expand recurring events — only returns seriesMaster. Use get-specific-calendar-view instead.

Inputs: calendarId (required), top, skip, count, +10 more.

list-subscriptionslist-subscriptionsA
Read-only

Retrieve the properties and relationships of webhook subscriptions, based on the app ID, the user, and the user's role with a tenant. The content of the response depends on the context in which the app is calling; for details, see the scenarios in the Permissions section.

💡 TIP: Lists webhook subscriptions owned by the current app/user. Returns id, resource, changeType, notificationUrl, expirationDateTime, clientState. Use $filter=resource eq '/me/messages' to find subscriptions for a specific resource. No dedicated 'Subscription.*' scope exists — the caller must already have a read permission for the subscribed resource (e.g. Mail.Read for /me/messages), which is supplied by the tool that reads that resource.

Inputs: top, skip, count, expand, +7 more.

list-supported-languageslist-supported-languagesA
Read-only

Get the list of locales and languages that are supported for the user, as configured on the user's mailbox server. When setting up an Outlook client, the user selects the preferred language from this supported list. You can subsequently get the preferred language by getting the user's mailbox settings.

💡 TIP: Lists locales and languages the user's mailbox server supports for the Outlook UI and message rendering. Returns localeInfo objects with locale (e.g. 'en-US') and displayName ('English (United States)'). Use this to validate the locale value before calling update-mailbox-settings to change the user's preferred language.

Inputs: top, skip, count, filter, +4 more.

list-supported-time-zoneslist-supported-time-zonesA
Read-only

Get the list of time zones that are supported for the user, as configured on the user's mailbox server. You can explicitly specify to have time zones returned in the Windows time zone format or Internet Assigned Numbers Authority (IANA) time zone (also known as Olson time zone) format. The Windows format is the default. When setting up an Outlook client, the user selects the preferred time zone from this supported list. You can subsequently get the preferred time zone by getting the user's mailbox settings.

💡 TIP: Lists time zones the user's mailbox server supports. TimeZoneStandard path parameter must be one of: Windows (default — Windows time zone names like 'Pacific Standard Time'), or Iana (IANA / Olson names like 'America/Los_Angeles'). Note the PascalCase — the values are case-sensitive enums, not lowercase strings. Returns timeZoneInformation objects with alias and displayName. Use the result to validate or look up the value before calling update-mailbox-settings to change the user's preferred timeZone — the format must match what the server expects.

Inputs: TimeZoneStandard (required), top, skip, count, +5 more.

list-todo-linked-resourceslist-todo-linked-resourcesA
Read-only

Get information of one or more items in a partner application, based on which a specified task was created. The information is represented in a linkedResource object for each item. It includes an external ID for the item in the partner application, and if applicable, a deep link to that item in the application.

💡 TIP: Lists resources linked to a To Do task (emails, URLs, etc.). Each linked resource has displayName, webUrl, applicationName, and externalId.

Inputs: todoTaskId (required), todoTaskListId (required), top, skip, +9 more.

list-todo-task-listslist-todo-task-listsA
Read-only

Get a list of the todoTaskList objects and their properties.

💡 TIP: Lists all To Do task lists. Returns todoTaskList-id needed for all task operations. The default list is typically called 'Tasks'. NOTE: $select is NOT supported by this endpoint — do not pass select parameter, Graph returns 400.

Inputs: top, skip, count, expand, +7 more.

list-todo-taskslist-todo-tasksA
Read-only

Get the todoTask resources from the tasks navigation property of a specified todoTaskList.

💡 TIP: Lists tasks in a To Do list. Requires todoTaskList-id — use list-todo-task-lists to find it. NOTE: $select is NOT supported — do not pass select, Graph returns 400. Use $filter=status eq 'notStarted' or $filter=status eq 'completed' to filter by status. Use $top to limit results. Status values: 'notStarted', 'inProgress', 'completed', 'waitingOnOthers', 'deferred'.

Inputs: todoTaskListId (required), top, skip, count, +8 more.

loginC

Authenticate with Microsoft account

Inputs: force.

logoutB

Log out from Microsoft account

Inputs: no named parameters.

merge-excel-rangemerge-excel-rangeA
Destructive

Merge an Excel range.

💡 TIP: Merge the cells in the given range into a single cell. Body: { across: false } merges the entire range into one cell; { across: true } merges each row separately. Useful for building styled headers, banner rows, and report layouts.

Inputs: body (required), address (required), driveId (required), driveItemId (required), +4 more.

move-mail-messagemove-mail-messageA
Destructive

Move a message to another folder within the specified user's mailbox. This creates a new copy of the message in the destination folder and removes the original message.

💡 TIP: destinationId accepts folder ID or well-known name (inbox, drafts, sentitems, deleteditems, junkemail, archive).

Inputs: body (required), messageId (required), confirm, includeHeaders, +1 more.

move-rename-onedrive-itemmove-rename-onedrive-itemA
Destructive

Move or rename a OneDrive item.

💡 TIP: Move and/or rename a file or folder. To move, provide parentReference with the target folder's id. To rename, provide a new name. Both can be done in a single request.

Inputs: body (required), driveId (required), driveItemId (required), confirm, +2 more.

parse-teams-urlA
Read-only

Converts any Teams meeting URL format (short /meet/, full /meetup-join/, or recap ?threadId=) into a standard joinWebUrl. Use this before list-online-meetings when the user provides a recap or short URL.

Inputs: url (required).

reauthorize-subscriptionreauthorize-subscriptionA
Destructive

Reauthorize a subscription when you receive a reauthorizationRequired challenge.

💡 TIP: Reauthorizes a subscription after receiving a 'reauthorizationRequired' lifecycle notification from Microsoft Graph. No body required. Must be called within the reauthorizationRequiredDateTime window (typically 48h) to avoid subscription expiry.

Inputs: subscriptionId (required), confirm, includeHeaders, excludeResponse.

remove-accountA

Remove a Microsoft account from the cache. Accepts email address (e.g. user@outlook.com) or account ID. Use list-accounts to discover available accounts.

Inputs: account (required).

reply-all-mail-messagereply-all-mail-messageA
Destructive

Reply to all recipients of a message using either JSON or MIME format. When using JSON format:

  • Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.

  • If the original message specifies a recipient in the replyTo property, per Internet Message Format (RFC 2822), send the reply to the recipients in replyTo and not the recipient in the from property. When using MIME format:

  • Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.

  • Add any attachments and S/MIME properties to the MIME content. This method saves the message in the Sent Items folder. Alternatively, create a draft to reply-all to a message and send it later.

💡 TIP: Reply-all preserving full HTML formatting. The 'comment' field is your reply text.

Inputs: body (required), messageId (required), confirm, includeHeaders, +1 more.

reply-mail-messagereply-mail-messageA
Destructive

Reply to the sender of a message using either JSON or MIME format. When using JSON format:

  • Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.

  • If the original message specifies a recipient in the replyTo property, per Internet Message Format (RFC 2822), send the reply to the recipients in replyTo and not the recipient in the from property. When using MIME format:

  • Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.

  • Add any attachments and S/MIME properties to the MIME content. This method saves the message in the Sent Items folder. Alternatively, create a draft to reply to an existing message and send it later.

💡 TIP: Reply to an email preserving full HTML formatting. The 'comment' field is your reply text. Do NOT reconstruct the email manually.

Inputs: body (required), messageId (required), confirm, includeHeaders, +1 more.

search-onedrive-filessearch-onedrive-filesA
Read-only

Search the hierarchy of items for items matching a query. You can search within a folder hierarchy, a whole drive, or files shared with the current user.

💡 TIP: Searches for files in a drive by name or content. The q parameter searches file names, metadata, and file content. Returns matching driveItems with id, name, webUrl, size, lastModifiedDateTime. Use list-drives first to get the drive-id.

Inputs: q (required), driveId (required), top, skip, +9 more.

select-accountA

Select a Microsoft account as the default. Accepts email address (e.g. user@outlook.com) or account ID. Use list-accounts to discover available accounts.

Inputs: account (required).

send-draft-messagesend-draft-messageB
Destructive

Send an existing draft message. The draft message can be a new message draft, reply draft, reply-all draft, or a forward draft. This method saves the message in the Sent Items folder. Alternatively, send a new message in a single operation.

💡 TIP: No request body needed — just call with the message ID. Draft must exist in Drafts folder.

Inputs: messageId (required), confirm, includeHeaders, excludeResponse.

send-mailsend-mailA
Destructive

Send the message specified in the request body using either JSON or MIME format. When using JSON format, you can include a file attachment in the same sendMail action call. When using MIME format: This method saves the message in the Sent Items folder. Alternatively, create a draft message to send later. To learn more about the steps involved in the backend before a mail is delivered to recipients, see here.

💡 TIP: CRITICAL: Do not try to guess the email address of the recipients. Use the list-users tool to find the email address of the recipients.

Inputs: body (required), confirm, includeHeaders, excludeResponse.

share-drive-itemshare-drive-itemA
Destructive

Send a sharing invitation for a driveItem. A sharing invitation provides permissions to the recipients and, optionally, sends them an email to notify them that the item was shared.

💡 TIP: Shares a file or folder with specific users. Body: { recipients: [{ email: 'user@example.com' }], roles: ['read'], sendInvitation: true, message: 'Please review this file.' }. Roles: 'read', 'write', 'owner'. Set requireSignIn to true to require authentication.

Inputs: body (required), driveId (required), driveItemId (required), confirm, +2 more.

snooze-calendar-event-remindersnooze-calendar-event-reminderA
Destructive

Postpone a reminder for an event in a user calendar until a new time.

💡 TIP: Postpones a triggered event reminder. Body: { NewReminderTime: { dateTime (ISO 8601), timeZone (IANA or Windows, e.g. 'Pacific Standard Time') } }. The reminder will re-fire at the new time.

Inputs: body (required), eventId (required), confirm, includeHeaders, +1 more.

sort-excel-rangesort-excel-rangeC
Destructive

Sort an Excel range.

Inputs: body (required), driveId (required), driveItemId (required), workbookWorksheetId (required), +3 more.

tentatively-accept-calendar-eventtentatively-accept-calendar-eventA
Destructive

Tentatively accept the specified event in a user calendar. If the event allows proposals for new times, on responding tentative to the event, an invitee can choose to suggest an alternative time by including the proposedNewTime parameter. For more information on how to propose a time, and how to receive and accept a new time proposal, see Propose new meeting times.

💡 TIP: Tentatively accepts a meeting invitation. Optional body: { sendResponse: true, comment: 'I might be able to attend.' }. Use proposedNewTime to suggest an alternative: { proposedNewTime: { start: { dateTime, timeZone }, end: { dateTime, timeZone } } }.

Inputs: body (required), eventId (required), confirm, includeHeaders, +1 more.

unmerge-excel-rangeunmerge-excel-rangeA
Destructive

Unmerge an Excel range.

💡 TIP: Unmerge any merged cells within the given range back into individual cells. No request body. Inverse of merge-excel-range.

Inputs: address (required), driveId (required), driveItemId (required), workbookWorksheetId (required), +3 more.

update-calendarupdate-calendarB
Destructive

Update a calendar.

💡 TIP: Updates a calendar's properties. Body: { name: 'New Name', color: 'lightBlue' }. Cannot update the default calendar's name.

Inputs: body (required), calendarId (required), confirm, includeHeaders, +1 more.

update-calendar-eventupdate-calendar-eventA
Destructive

Update the properties of the event object.

💡 TIP: CRITICAL: Do not try to guess the email address of the recipients. Use the list-users tool to find the email address of the recipients. WARNING: Setting attendees replaces the entire attendee list — include all attendees, not just new ones.

Inputs: body (required), eventId (required), confirm, includeHeaders, +1 more.

update-contact-folderupdate-contact-folderA
Destructive

Update the properties of contactfolder object.

💡 TIP: Updates a contact folder. Body: { displayName?: 'New name', parentFolderId?: '' } — both displayName (rename) and parentFolderId (move) are writable. The default 'Contacts' folder may not be renameable. Get the folder id via list-contact-folders.

Inputs: body (required), contactFolderId (required), confirm, includeHeaders, +1 more.

update-excel-rangeupdate-excel-rangeA
Destructive

Update an Excel range.

💡 TIP: Set cell values, formulas, or number format on any range — does NOT require the worksheet to be a formal Excel table. Body: { values: [['v1','v2','v3']] } for a single row, or [['a','b'],['c','d']] for multi-row. Use this for append (target the next empty row's address, e.g. 'A172:H172'), update (target a single cell like 'H42'), or prepend-style edits (read existing, concatenate, write back). Number of inner-array values must match the column count of the address.

Inputs: body (required), address (required), driveId (required), driveItemId (required), +4 more.

update-excel-table-rowupdate-excel-table-rowA
Destructive

Update an Excel table row.

💡 TIP: Update a single row in a formal Excel table by zero-based row index. Body: { values: [[...]] } with one inner array matching the column count.

Inputs: body (required), index (required), driveId (required), driveItemId (required), +4 more.

update-focused-inbox-overrideupdate-focused-inbox-overrideA
Destructive

Change the classifyAs field of an override as specified. You cannot use PATCH to change any other fields in an inferenceClassificationOverride instance. If an override exists for a sender and the sender changes his/her display name, you can use POST to force an update to the name field in the existing override. If an override exists for a sender and the sender changes his/her SMTP address, deleting the existing override and creating a new one with the new SMTP address is the only way to 'update' the override for this sender.

💡 TIP: Updates the classifyAs field of an existing override. Body: { classifyAs: 'focused' } or { classifyAs: 'other' }. Per Graph API, PATCH cannot change senderEmailAddress — to change the SMTP address, delete and recreate the override. To rename the display name only, POST a new override with the same SMTP address (it will overwrite the name).

Inputs: body (required), inferenceClassificationOverrideId (required), confirm, includeHeaders, +1 more.

update-mailbox-settingsupdate-mailbox-settingsC
Destructive

Enable, configure, or disable one or more of the following settings as part of a user's mailboxSettings: When updating the preferred date or time format for a user, specify it in respectively, the short date or short time format. When updating the preferred time zone for a user, specify it in the Windows or Internet Assigned Numbers Authority (IANA) time zone (also known as Olson time zone) format. You can also further customize the time zone as shown in example 2 below.

💡 TIP: Updates mailbox settings. Common use: configure Out-of-Office (automatic replies). Body example: { automaticRepliesSetting: { status: 'scheduled', scheduledStartDateTime: { dateTime: '2026-03-28T17:00:00', timeZone: 'Eastern Standard Time' }, scheduledEndDateTime: { dateTime: '2026-04-01T08:00:00', timeZone: 'Eastern Standard Time' }, internalReplyMessage: 'I am OOO.', externalReplyMessage: 'I am out of office.' } }. Status values: disabled, alwaysEnabled, scheduled.

Inputs: body (required), confirm, includeHeaders, excludeResponse.

update-mail-folderupdate-mail-folderA
Destructive

Update the properties of mailfolder object.

💡 TIP: Renames a mail folder by updating its displayName. Use list-mail-folders to find the folder ID.

Inputs: body (required), mailFolderId (required), confirm, includeHeaders, +1 more.

update-mail-messageupdate-mail-messageA
Destructive

Update an existing Outlook email message by its message ID — for example mark it read or unread (isRead), flag it (flag), change its categories, importance, or edit a draft's subject, body, or recipients.

Inputs: body (required), messageId (required), confirm, includeHeaders, +1 more.

update-mail-ruleupdate-mail-ruleA
Destructive

Change writable properties on a messageRule object and save the changes.

💡 TIP: Updates an existing message rule. Use the Inbox folder ID (get it from list-mail-folders) for inbox rules. Send only the properties to change. Common use: { isEnabled: false } to disable a rule, or update conditions/actions.

Inputs: body (required), mailFolderId (required), messageRuleId (required), confirm, +2 more.

update-my-calendar-permissionupdate-my-calendar-permissionA
Destructive

Update my calendar permission.

💡 TIP: Changes the role (permission level) granted to an existing share recipient or delegate. Body: { role: 'read' | 'write' | 'delegateWithoutPrivateEventAccess' | 'delegateWithPrivateEventAccess' }. Only the role property is writable — to change the recipient's email or other properties, delete and recreate via delete-my-calendar-permission + create-my-calendar-permission. Get the permission id via list-my-calendar-permissions.

Inputs: body (required), calendarPermissionId (required), confirm, includeHeaders, +1 more.

update-outlook-contactupdate-outlook-contactB
Destructive

Update the properties of a contact object.

💡 TIP: emailAddresses array is replaced entirely — include all addresses, not just new ones.

Inputs: body (required), contactId (required), confirm, includeHeaders, +1 more.

update-planner-bucketupdate-planner-bucketA
Destructive

Update the properties of plannerbucket object.

💡 TIP: CRITICAL: Requires If-Match header with ETag from get-planner-bucket (use includeHeaders=true).

Inputs: body (required), If-Match (required), plannerBucketId (required), confirm, +2 more.

update-planner-taskupdate-planner-taskA
Destructive

Update the properties of plannerTask object.

💡 TIP: CRITICAL: Requires If-Match header with the task's @odata.etag value, otherwise returns 412 Precondition Failed. Get the ETag from get-planner-task with includeHeaders=true. Priority values: 0=Urgent, 1=Important, 3=Medium, 5=Low, 9=unset.

Inputs: body (required), If-Match (required), plannerTaskId (required), confirm, +2 more.

update-planner-task-detailsupdate-planner-task-detailsA
Destructive

Update the properties of plannerTaskDetails object.

💡 TIP: CRITICAL: Requires If-Match header with ETag from get-planner-task-details (use includeHeaders=true). Checklist items use GUID keys: {"checklist": {"": {"title": "...", "isChecked": false}}}.

Inputs: body (required), If-Match (required), plannerTaskId (required), confirm, +2 more.

update-specific-calendar-eventupdate-specific-calendar-eventA
Destructive

Update a specific calendar event.

💡 TIP: CRITICAL: Do not try to guess the email address of the recipients. Use the list-users tool to find the email address of the recipients. WARNING: Setting attendees replaces the entire attendee list — include all attendees, not just new ones.

Inputs: body (required), eventId (required), calendarId (required), confirm, +2 more.

update-subscriptionupdate-subscriptionA
Destructive

Renew a subscription by extending its expiry time. The table in the Permissions section lists the resources that support subscribing to change notifications. Subscriptions expire after a length of time that varies by resource type. In order to avoid missing change notifications, an app should renew its subscriptions well in advance of their expiry date. See subscription for maximum length of a subscription for each resource type.

💡 TIP: Renews a webhook subscription by extending its expiration. Body: { expirationDateTime (ISO 8601, new expiry) }. Call before the current expirationDateTime to avoid missing notifications. Max extension varies by resource type — check Microsoft Graph docs for subscription limits.

Inputs: body (required), subscriptionId (required), confirm, includeHeaders, +1 more.

update-todo-taskupdate-todo-taskA
Destructive

Update the properties of a todoTask object.

💡 TIP: Updates a Microsoft To Do task. Use this to mark a to-do item complete or done (body: { status: "completed" }), reopen it (status: "notStarted"), rename it (title), or change its due date (dueDateTime), reminder (reminderDateTime), importance, or notes (body). Requires todoTaskListId from list-todo-task-lists and todoTaskId from list-todo-tasks.

Inputs: body (required), todoTaskId (required), todoTaskListId (required), confirm, +2 more.

update-todo-task-listupdate-todo-task-listA
Destructive

Update the properties of a todoTaskList object.

💡 TIP: Renames a Microsoft To Do task list. Body: { displayName: 'New name' }. Only displayName is writable. Built-in lists (Flagged emails, the default Tasks list) cannot be renamed — the API returns an error. Get list ids via list-todo-task-lists.

Inputs: body (required), todoTaskListId (required), confirm, includeHeaders, +1 more.

upload-file-contentupload-file-contentA
Destructive

The content stream, if the item represents a file.

💡 TIP: Body is a base64-encoded string of the file bytes; the server decodes it before PUT. Graph accepts up to 250MB here, but the whole string travels as a tool argument and a truncated one decodes to a truncated file with no error, so use create-upload-session rather than emitting a large base64 string. For new files use path format: /items/root:/path/to/file.txt:/content. Overwrites existing files without warning.

Inputs: body (required), driveId (required), driveItemId (required), confirm, +2 more.

upload-my-profile-photoupload-my-profile-photoA
Destructive

Update the photo for the specified contact, group, team, or user in a tenant. The size of the photo you can update to is limited to 4 MB. You can use either PATCH or PUT for this operation.

💡 TIP: Uploads a new profile photo for the signed-in user. Body is a base64-encoded string of the image bytes (the server decodes before PUT). Photo must be JPEG, max 4 MB; the base64 travels as a tool argument and a truncated one is written without error, so resize before encoding instead of emitting a large string. Microsoft 365 generates HD downsized variants automatically (48x48, 64x64, 96x96, 120x120, 240x240, 360x360, 432x432, 504x504, 648x648). For work or school accounts, ProfilePhoto.ReadWrite.All is the more granular alternative permission. Use download-bytes with target=/me/photo/$value to retrieve the current photo.

Inputs: body (required), confirm, includeHeaders, excludeResponse.

verify-loginA

Check current Microsoft authentication status

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.7/5.0

    Scored across 188 tools

    Disambiguation2/5

    With 188 tools, many have unclear or overlapping boundaries: calendar listing alone has list-calendar-events, list-specific-calendar-events, get-calendar-view, get-specific-calendar-view, list-calendar-view-delta, and list-calendar-events-delta. Download tools (download-bytes, download-bytes-to-file, get-download-url) and OneNote page creators (create-onenote-page vs create-onenote-section-page) are also easily confused, and list-excel-tables/get-excel-table share identical descriptions.

    Naming Consistency3/5

    Most tools follow a readable kebab-case verb_noun pattern (list-, get-, create-, update-, delete-), but object terminology is inconsistent: drive vs onedrive (get-drive-item vs move-rename-onedrive-item), planner vs plan (get-planner-plan vs list-plan-buckets), and parallel actions diverge (create-draft-email vs create-reply-draft; add-excel-table-rows vs create-excel-table). The pattern is recognizable but not predictable enough for a 188-tool surface.

    Tool Count1/5

    188 tools is an extreme count, far exceeding the 50+ threshold for a 1. Even for a broad Microsoft Graph wrapper, this is unwieldy and would be better split into purpose-specific servers for mail, calendar, files, Excel, OneNote, Planner, and To Do.

    Completeness2/5

    Despite the massive surface, the server has significant gaps: list-users, list-online-meetings, and get-schedule are all referenced in tool tips but are not actual tools, creating dead ends. Within covered domains, CRUD is incomplete (no delete-planner-task, no delete-onenote-section, no create/update/delete planner plan, no Outlook category update/delete), and major M365 areas like Teams, SharePoint sites, and admin are essentially absent.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers