M365 Roadmap

Query the Microsoft 365 Roadmap from AI agents

AI & MLPythonv0.4.0

Disclaimer: This is an independent, self-built project and is not an official Microsoft tool or service.

M365 Roadmap MCP Server

A Python-based MCP (Model Context Protocol) server that enables AI agents to query the Microsoft 365 Roadmap programmatically.

Strategic Rationale

For organizations relying on Microsoft 365, Teams, or SharePoint, the "Roadmap" is the single source of truth for upcoming changes. However, navigating the roadmap website manually is cumbersome and disconnected from technical planning workflows. "When is Copilot coming to GCC High?" is a question that affects multi-million dollar contracts and deployment schedules.

Existing research indicates that while RSS feeds exist, there is no tool that allows an AI agent to structurally query this data to answer complex filtering questions. A "Roadmap Scout" MCP server empowers the Agent to act as a release manager, proactively identifying features that enable new capabilities or threaten existing customizations.

Prompt Examples

Once connected to an MCP client, you can ask questions like:

  1. Search by product and status: "What Microsoft Teams features are currently rolling out?"
  2. Check government cloud availability: "Is Copilot available for GCC High yet?"
  3. Find recent additions: "Show me everything added to the M365 roadmap in the last 30 days"
  4. Get feature details: "Tell me more about roadmap feature 534606"
  5. Government cloud planning: "My agency is on GCC High. Which OneDrive features can we expect?"

Installation

Prerequisites

  • Python 3.11+
  • An MCP-compatible client (Claude Desktop, Cursor, Claude Code, GitHub Copilot CLI, etc.)

From PyPI (recommended)

Using uvx (requires uv):

uvx m365-roadmap-mcp

To update to the latest version:

uvx m365-roadmap-mcp@latest

Install uv if you don't have it:

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
irm https://astral.sh/uv/install.ps1 | iex

Or install with pip (no uv required):

pip install m365-roadmap-mcp

# Update to latest
pip install --upgrade m365-roadmap-mcp

Quick Setup

Install in VS Code Install in Cursor Install in Claude Code Install in Copilot CLI

One-click install: Click VS Code badge for automatic setup (requires uv installed) Manual install: See instructions below for Cursor, Claude Code, Copilot CLI, or Claude Desktop

Client Configuration

Running the server

uvx m365-roadmap-mcp

Or if installed with pip:

m365-roadmap-mcp

Claude Desktop

Add to your Claude Desktop MCP config:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Using uvx (recommended)

{
  "mcpServers": {
    "m365-roadmap": {
      "command": "uvx",
      "args": ["m365-roadmap-mcp"]
    }
  }
}

Using installed package

{
  "mcpServers": {
    "m365-roadmap": {
      "command": "m365-roadmap-mcp"
    }
  }
}

Cursor

Option 1: One-Click Install (Recommended)

cursor://anysphere.cursor-deeplink/mcp/install?name=m365-roadmap-mcp&config=eyJjb21tYW5kIjogInV2eCIsICJhcmdzIjogWyJtMzY1LXJvYWRtYXAtbWNwIl19

Option 2: Manual Configuration

Add to your Cursor MCP config:

  • macOS: ~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  • Windows: %APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

Claude Code

claude mcp add --transport stdio m365-roadmap -- uvx m365-roadmap-mcp

GitHub Copilot CLI

Add to ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "m365-roadmap": {
      "type": "stdio",
      "command": "uvx",
      "args": ["m365-roadmap-mcp"]
    }
  }
}

Features

Provides a single search_roadmap tool that handles all M365 roadmap queries. Combine any filters:

  • Keyword search -- Find features by keyword in title/description
  • Product filter -- Filter by product tag (Teams, SharePoint, etc.)
  • Status filter -- Filter by status (In development, Rolling out, Launched)
  • Cloud instance filter -- Filter by cloud instance (GCC, GCC High, DoD)
  • Feature lookup -- Retrieve full metadata for a specific roadmap ID
  • Recent additions -- List features added within the last N days
  • Release phase filter -- Filter by release phase (General Availability, Preview, Targeted Release)
  • Platform filter -- Filter by platform (Web, Desktop, iOS, Android, Mac)
  • Rollout date filter -- Filter by general availability date (e.g., "2026-03", "2026")
  • Preview date filter -- Filter by preview availability date (e.g., "2026-07", "2026")
  • Recently modified -- List features modified within the last N days

Data Source

This MCP server pulls data from Microsoft's public roadmap API:

  • API Endpoint: https://www.microsoft.com/releasecommunications/api/v2/m365
  • Authentication: None required (public endpoint)
  • RSS Mirror: https://www.microsoft.com/microsoft-365/RoadmapFeatureRSS (same data, RSS format)

This is the same data that powers the Microsoft 365 Roadmap website. The legacy endpoint (roadmap-api.azurewebsites.net) was retired in March 2025.

Coverage and Limitations

The API returns approximately 1,900 active features -- those currently In Development, Rolling Out, or recently Launched. This is a hard cap; older or retired features age out of the API and are no longer returned. The roadmap website may display historical features that are no longer present in the API.


License

MIT

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
uvx m365-roadmap-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-jonnybottles-m365-roadmap": {
      "command": "uvx",
      "args": [
        "m365-roadmap-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

m365-roadmap-mcppypi

Compatible MCP Clients

M365 Roadmap works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More