claudio 0.2.3

MCP server for Claude Code that enables audio understanding via Gemini

Claudio

MCP server for Claude Code that enables audio understanding via Gemini. Ask questions about audio files - describe music, transcribe lyrics, identify instruments, and more.

What is this?

Claudio is an MCP (Model Context Protocol) server that gives Claude Code the ability to listen to and analyze audio files. It uses Google's Gemini API for audio understanding.

Setup

1. Get a Gemini API Key

Get an API key at Google AI Studio.

2. Add to Claude Code

claude mcp add claudio -e GEMINI_API_KEY=your-key -- uvx claudio

Tools

listen_to_audio

Start listening to an audio file and ask a question about it.

Parameter	Type	Description
file_path	string	Absolute path to a local audio file
question	string	Your question about the audio (e.g., "Describe this music", "Transcribe the lyrics")

Returns an answer and a session ID for follow-up questions.

ask_about_audio

Ask a follow-up question about audio from an existing session.

Parameter	Type	Description
session_id	string	Session ID from a previous listen_to_audio call
question	string	Your follow-up question

Supported Formats

WAV, MP3, AIFF, AAC, OGG, FLAC

Files under 20MB are sent inline; larger files are uploaded via Gemini's Files API.