Skip to main content

MCP server for querying the Microsoft 365 Roadmap

Project description

M365 Roadmap MCP Server

mcp-name: io.github.jonnybottles.m365-roadmap

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

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

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

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

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

From source (for development)

git clone https://github.com/jonnybottles/M365-roadmap-mcp-server.git
cd M365-roadmap-mcp-server
pip install -e ".[dev]"

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"]
    }
  }
}

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).


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.

Development

pytest

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.0.tar.gz (656.9 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.0-py3-none-any.whl (11.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: m365_roadmap_mcp-0.2.0.tar.gz
  • Upload date:
  • Size: 656.9 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.0.tar.gz
Algorithm Hash digest
SHA256 ec391a171414452ddc56d43bd0998bcb37c03c85e4a45187ac0749f20bb7f823
MD5 2e3fc7de9cd0831b96490985bd7e78ed
BLAKE2b-256 4d6b0c1664ac8f125ca83bc9ff59bd83e963e9c896b33a9fad6f6b79fc57dcf4

See more details on using hashes here.

Provenance

The following attestation bundles were made for m365_roadmap_mcp-0.2.0.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.0-py3-none-any.whl.

File metadata

File hashes

Hashes for m365_roadmap_mcp-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c9edffd9807b7cfc4b58f4cccd8a01eb5dce82cb8182d39084b1daeab91e9fc2
MD5 0d613dd74cdf47aad980b9d07c625cf3
BLAKE2b-256 bd95e0628251d8fde2559e1729b960411f99831b9654bc365cfdbecc5a361d68

See more details on using hashes here.

Provenance

The following attestation bundles were made for m365_roadmap_mcp-0.2.0-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