osu! MCP

Name: osu! MCP
Author: Osyanne

MCP

by Osyanne · v0.1.4

MCP server exposing the osu! API v2: player stats, scores, beatmap search, rankings.

mcplocal

MCP configuration

stdio

Command

uvx osu-mcp==0.1.4

Environment

OSU_CLIENT_IDrequired
Numeric Client ID from your osu! OAuth application (https://osu.ppy.sh/home/account/edit).
OSU_CLIENT_SECRETrequiredsecret
Client Secret from the same osu! OAuth application.

Browse here, install from the native macOS app — pick targets, fill env vars, and write configs safely.