♩Clef:

Clef Music Tools MCP server

Music theory helpers for piano players: transpose chord charts, spell any chord as piano notes with MIDI numbers, turn guitar tab into piano pitches, and find Clef guides on converting music between formats.

  • Endpoint: https://clefdrills.com/mcp
  • Transport: Streamable HTTP (remote server, no install)
  • Auth: none
  • Tools: transpose_chords, spell_piano_chord, tab_to_piano_notes, find_music_guides (all read-only)
  • Server card: /.well-known/mcp/server-card.json
  • Support: support@clefdrills.com

Pages in this guide

  • Connect a client: Claude, ChatGPT, Cursor, VS Code, generic config and a curl check
  • transpose_chords: Move a chord chart up or down by semitones, including slash bass notes.
  • spell_piano_chord: List the notes of one chord symbol as piano pitches with octave and MIDI number.
  • tab_to_piano_notes: Convert six-string ASCII guitar tab to sounding piano pitches, one event per tab column.
  • find_music_guides: Find Clef guides by words in the title and description.
  • Limits and privacy: what the tools cannot do, input limits, privacy

Quick start

Claude Code:

claude mcp add --transport http clef-music-tools https://clefdrills.com/mcp

Cursor, and any client that reads mcpServers:

{
  "mcpServers": {
    "clef-music-tools": {
      "url": "https://clefdrills.com/mcp"
    }
  }
}

Other clients are covered on the connect page.

Example

Transpose a chord chart up two semitones with transpose_chords:

curl -s https://clefdrills.com/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"transpose_chords","arguments":{"chords":"C G/B Am F","semitones":2}}}'

Result:

{ "chords": "D A/C# Bm G", "browserTool": "https://clefdrills.com/tools/chord-transposer/" }

Limits and privacy

The tools take text only: no audio, PDFs, MusicXML or uploaded files. They are read-only, need no account and do not store what you send. Details are on the limits and privacy page.

Support

Email support@clefdrills.com. More help on the support page.