osu! MCP Server: Install & Setup

Install osu! in Claude Code

Claude Code

claude mcp add osu -e OSU_CLIENT_ID=... -e OSU_CLIENT_SECRET=... -- uvx osu-mcp

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

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

Replace each ... with your own value.

Frequently asked questions

What does the osu! MCP server do?

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

Is the osu! MCP server free?

The server is free, but you will likely need an account. The server itself is free, but it connects to a service that needs an account or API key, which may have paid tiers. Check the provider for current pricing.

Does osu! run locally or remotely?

Local. Runs on your machine (stdio). You install it with npx, uvx, Docker or from source.

How do I add osu! to Claude Code?

Run: claude mcp add osu -e OSU_CLIENT_ID=... -e OSU_CLIENT_SECRET=... -- uvx osu-mcp

More search & web scraping MCP servers

View all

Outlook Mail

Pepebits/outlook-mcp

Read, search, send and clean up Outlook.com / Hotmail mail through Microsoft Graph.

LocalFree

OSINT.SX

osintsx/osintsx-mcp

Search an email, phone, username or name across every OSINT.SX source, plus account history tools.

LocalAccount needed

Outrank

03.7k

Outrank-SAS/outrank-cli

Plan SEO keywords, write and publish articles to your site, read Search Console and backlink data

Local + RemoteAccount needed

Osdev Wiki

0xmortuex/osdev-wiki-mcp

The OSDev wiki (wiki.osdev.org) offline and searchable: search, sections, links.

LocalFree

OwnSearch

devops-infinity/ownsearch

Quality-ranked SearXNG search over MCP with local fleet state, scoring, and merged results.

LocalFree

Orita

Alkilo-do/orita-mcp

Provider resolution for AI apps — search, rank, hold, confirm bookings across your provider network.

LocalAccount needed