intune-mcp
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@intune-mcpWhich devices are noncompliant?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
intune-mcp
MCP server providing read-only access to Microsoft Intune via the Microsoft Graph API. Allows Claude (or any MCP client) to query managed devices, apps, compliance policies, and configuration profiles.
Prerequisites
Node.js >= 18
An Azure AD (Entra ID) app registration with delegated permissions
Azure CLI (
az) for automated app registration (optional)
Related MCP server: azure-query-mcp
Quick Start
1. Register the Azure AD App
# Automated (requires Azure CLI + admin consent permissions)
.\scripts\register-app.ps1 -WriteEnv
# Or manually: create a public client app in Entra ID with these delegated permissions:
# - DeviceManagementManagedDevices.Read.All
# - DeviceManagementApps.Read.All
# - DeviceManagementConfiguration.Read.All
# Then create .env:
# AZURE_CLIENT_ID=<your-app-client-id>
# AZURE_TENANT_ID=<your-tenant-id>2. Install and Build
npm install
npm run build3. Authenticate
npm run authFollow the device code prompt to sign in with your Microsoft account.
4. Run
# Stdio mode (for local MCP clients like Claude Code)
npm start
# HTTP mode (for shared/remote deployment)
npm run start:httpTransport Modes
Mode | Flag | Use Case |
Stdio | (default) | Local, single-user, pre-authenticated |
HTTP |
| Shared deployment, multi-session, per-session auth |
HTTP mode starts an Express server on port 3000 (configurable via --port or PORT env var) with endpoints:
Path | Method | Purpose |
| POST | MCP JSON-RPC (Streamable HTTP) |
| GET | SSE stream for server notifications |
| DELETE | Session termination |
| GET | Health check (status, version, session count) |
Available Tools
Category | Tool | Description |
Auth |
| Device code sign-in (HTTP mode only) |
Devices |
| List managed devices with OData filter |
Devices |
| Get device details by ID |
Devices |
| Search by name, UPN, or serial number |
Apps |
| Detected apps on a device (beta API) |
Apps |
| LOB/store/web apps in Intune |
Compliance |
| All compliance policies |
Compliance |
| Per-device compliance state |
Compliance |
| Devices with noncompliant state |
Compliance |
| Per-device status for a policy |
Config Profiles |
| Device configuration profiles |
Config Profiles |
| Per-device status for a profile |
Config Profiles |
| Profile states on a device |
Required Permissions (Delegated)
DeviceManagementManagedDevices.Read.AllDeviceManagementApps.Read.AllDeviceManagementConfiguration.Read.All
Development
npm run dev # TypeScript watch mode
npm test # Run unit tests
npm run build # Compile to dist/Live Validation
Test all 12 endpoints against a real Intune tenant (requires prior authentication):
node scripts/validate-tools.mjsArchitecture
MCP Client -> Transport (stdio | HTTP) -> McpServer -> Tool Handlers -> GraphClient -> Microsoft Graph APIAuth: MSAL device code flow, file-based token cache at
~/.intune-mcp/token-cache.jsonLogging: Structured JSON-lines at
~/.intune-mcp/logs/intune-mcp.log(10 MB rotation, 5 files)Graph client: Automatic retry with exponential backoff (429, 401, 5xx),
Retry-Aftersupport, 30s request timeout, auto-pagination up to 10 pagesHTTP mode: Per-session auth, 30-minute session TTL, 100-session cap
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides read-only access to Microsoft 365 services including SharePoint, OneDrive, Outlook, Teams, and Calendar through the Microsoft Graph API, enabling users to search, browse, and retrieve content across their M365 suite.1MIT
- AlicenseAqualityCmaintenanceEnables read-only querying of Azure Log Analytics and Azure Resource Graph through MCP, supporting KQL queries, workspace discovery, and resource inventory exploration with Azure RBAC authentication.52MIT
- AlicenseBqualityBmaintenanceA read-only MCP server for Microsoft Intune and Entra ID that enables list, get, search, and reporting operations for tenant visibility, audits, troubleshooting, and health reporting without write actions. It includes authentication helpers, report exports, and metadata discovery tools.36MIT
- FlicenseNot gradedqualityCmaintenanceRead-only MCP server for Microsoft Entra ID (Azure AD) that enables querying user sign-in logs, group memberships, and assigned Microsoft 365 licenses via Microsoft Graph API. Provides security and audit visibility without any write operations.
Related MCP Connectors
XFA's remote MCP server — query device posture, compliance, policies & CVEs. Read-only.
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
Official Microsoft MCP Server to query Microsoft Entra data using natural language
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/wborcherdt26/Intune-MCP'
If you have feedback or need assistance with the MCP directory API, please join our Discord server