Skip to main content

MCP server for querying the Microsoft 365 Roadmap

Project description

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

Data Source

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

  • API Endpoint: https://www.microsoft.com/releasecommunications/api/v1/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.

There is no official Microsoft documentation for this API. It is a public, unauthenticated endpoint that the community has reverse-engineered. Microsoft Graph does not expose the public M365 roadmap (Graph's Service Communications API covers tenant-specific Message Center posts and Service Health, which is different data).


License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

m365_roadmap_mcp-0.2.1.tar.gz (651.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

m365_roadmap_mcp-0.2.1-py3-none-any.whl (11.1 kB view details)

Uploaded Python 3

File details

Details for the file m365_roadmap_mcp-0.2.1.tar.gz.

File metadata

  • Download URL: m365_roadmap_mcp-0.2.1.tar.gz
  • Upload date:
  • Size: 651.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for m365_roadmap_mcp-0.2.1.tar.gz
Algorithm Hash digest
SHA256 e3f0122bc64bb7964f4ed521a0ca95104b90088248b95664a9a7b5312b47fe98
MD5 94905cc12f96507f050a28ea753b41e4
BLAKE2b-256 37460618668d6418694e41d23460cdd41ae626c3190884059abe69abad3861c8

See more details on using hashes here.

Provenance

The following attestation bundles were made for m365_roadmap_mcp-0.2.1.tar.gz:

Publisher: publish.yml on jonnybottles/M365-roadmap-mcp-server

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file m365_roadmap_mcp-0.2.1-py3-none-any.whl.

File metadata

File hashes

Hashes for m365_roadmap_mcp-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 0c7cdfd451a45f422cbccb1363cd06edac7771bc879638d01fdb8876f4729f19
MD5 c65f2720847a2d0016376b0d1aeaa94c
BLAKE2b-256 0df31cb7adf0b69958bc1390b1134991546411fd9d498bfb3f139452f22266eb

See more details on using hashes here.

Provenance

The following attestation bundles were made for m365_roadmap_mcp-0.2.1-py3-none-any.whl:

Publisher: publish.yml on jonnybottles/M365-roadmap-mcp-server

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page