msevent

This MCP server exposes the Microsoft Events API as a set of utilities that let you search, inspect, filter, and analyze Microsoft events (conferences, workshops, webinars) from any MCP-compatible client (e.g., Claude, Cursor, or a custom integration). The server provides tools to perform full-text searches with filters, retrieve detailed event information by ID, discover available filter categories and counts, and gather aggregated statistics by various dimensions. You can invoke tools such as search_events, get_event_details, list_filters, and get_event_stats to build conversational interfaces or automated workflows that reason about event data.

To use it, run the MCP server using uvx, which will launch the msevent-mcp package in an isolated environment and keep it up to date. Once the server is running, configure your MCP client to point at it using the server name microsoft-events and the appropriate command and arguments provided in the mcp_config. Then you can call the available tools from your client, passing optional filters or locale settings as needed to retrieve results in the desired language or region.

Prerequisites:

• Python 3.10+ installed on your system
• internet access to install dependencies
• Optional: uv/uvx tooling if you prefer running via uvx (recommended for Claude integration)

Install from source (development):

1. Clone the repository git clone https://github.com/trsdn/msevent-mcp.git cd msevent-mcp

2. Install Python dependencies pip install -r requirements.txt

3. Run the MCP server locally python mcp_server.py

If you want to run via uvx (recommended for Claude Desktop integration):

1. Ensure uv and uvx are installed (uvx is available via uv and installs in an isolated environment)
2. Run the server in your MCP config (see below). Example for uvx usage: uvx msevent-mcp

Example MCP config for Claude or another MCP client (from the repo's Quick Start):

To add via Claude Code:

claude mcp add microsoft-events uvx msevent-mcp

To add via Claude Desktop config (json):

{
  "mcpServers": {
    "microsoft-events": {
      "command": "uvx",
      "args": ["msevent-mcp"]
    }
  }
}

Notes and tips:

• The server uses an in-memory cache for event data to speed up repeated queries during the process lifetime; restart will rehydrate the cache from the source API.
• The API does not require an API key for Microsoft Events, as documented in the MCP API reference for this project.
• For development testing, you can run unit tests with pytest as shown in the README; some tests may require network access for live API tests.
• If you encounter locale issues, you can utilize the Multi-Locale feature by passing locale codes such as de-de or en-us when calling tools like search_events or list_filters.
• The uvx/uv approach is designed to keep the environment isolated and up to date automatically when used in Claude-based workflows.