osu! MCP

Overview

osu! MCP is a Model Context Protocol server that connects AI assistants directly to the osu! API v2. It exposes player statistics, score data, beatmap search, and ranking information, letting any MCP-compatible assistant query and interact with osu! game data seamlessly during conversations or agent tasks.

The server runs locally as a Python package installed via uvx osu-mcp and communicates over stdio. You'll need to provide OSU_CLIENT_ID and OSU_CLIENT_SECRET as environment variables for authentication. The latest release is v0.1.4, distributed under the MIT license with source code available at Osyanne/osu-mcp on GitHub.

osu! MCP appears in the AI & Agents category on mcp.site and integrates with all major MCP clients including Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, and Zed. Maintainers of Osyanne/osu-mcp are welcome to claim this listing, verify ownership, and keep information up to date.

Installation

// claude_desktop_config.json
{
  "mcpServers": {
    "osu_mcp": {
      "command": "uvx",
      "args": [
        "osu-mcp"
      ],
      "env": {
        "OSU_CLIENT_ID": "<osu-client-id>",
        "OSU_CLIENT_SECRET": "<osu-client-secret>"
      }
    }
  }
}

Requires OSU_CLIENT_ID, OSU_CLIENT_SECRET