osu! MCP

Indexed by io.github.Osyanne

About

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

Use this server

Add it to your MCP client. The catalogue lists this config verbatim from its source — it does not run, download, or vouch for the server. Review the command before you run it.

Transportstdio (runs a local command)

Env varsOSU_CLIENT_ID OSU_CLIENT_SECRET

Claude Code

claude mcp add --env OSU_CLIENT_ID= --env OSU_CLIENT_SECRET= osu-mcp -- uvx osu-mcp

Cursor

Add to Cursor

If the button doesn't open Cursor, use the JSON below — Cursor accepts the same mcpServers config.

VS Code

code --add-mcp '{"name":"osu-mcp","command":"uvx","args":["osu-mcp"],"env":{"OSU_CLIENT_ID":"","OSU_CLIENT_SECRET":""}}'

JSON

{
  "mcpServers": {
    "osu-mcp": {
      "command": "uvx",
      "args": [
        "osu-mcp"
      ],
      "env": {
        "OSU_CLIENT_ID": "",
        "OSU_CLIENT_SECRET": ""
      }
    }
  }
}

Environment variables are listed by name only — fill in your own values. Entries never carry secrets.