osu! MCP Server

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

claude mcp add osu-mcp -- uvx osu-mcp

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

[mcp_servers.osu-mcp]
command = "uvx"
args = ["osu-mcp"]

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

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

This one needs environment variables set before it will start: OSU_CLIENT_ID (Numeric Client ID from your osu! OAuth application (https://osu.ppy.sh/home/account/edit).), OSU_CLIENT_SECRET (Client Secret from the same osu! OAuth application.). The author declared them in the registry entry; get the values from the project itself.