flow-music-mcp
Provides tools for interacting with Google Flow Music, Google Labs' AI music studio (Lyria): generate songs and lyrics, extend/replace/cover songs, split stems, create videos, chat with the Producer agent, manage songs, sessions, playlists and Spaces, and download audio, video, or cover art.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
flow-music-mcp
flow-music-mcp is a single-binary Rust stdio Model Context Protocol (MCP) server for Google Flow Music, the AI music studio from Google Labs (Lyria). It serves 18 MCP tools and download resources through rmcp over standard input and output.
ChromeEngine keeps a persistent Chrome or Chromium profile in <home>/chrome-profile (0700 permissions on Unix). During background work, it connects over local Chrome DevTools Protocol (CDP) to headless Chrome (--headless=new) and keeps one page on https://www.flowmusic.app. An embedded TypeScript runtime sends the internal API requests from that page with the session of the page. During Google Sign-In in music_login, the server opens a visible Chrome window without CDP flags.
A single-worker JobQueue runs generation, lyrics, edit, stem, video, and chat jobs one at a time. The queue never retries a job automatically, because jobs spend credits. Finished audio goes into <home>/downloads with natural file names, and a SQLite index records each file.
Quick install
Install Node.js 18 or newer and Google Chrome or Chromium on your host computer:
npx -y @flow-music-mcp/cli --helpnpm installs the matching optional package (@flow-music-mcp/darwin-arm64, @flow-music-mcp/darwin-x64, @flow-music-mcp/linux-arm64, @flow-music-mcp/linux-x64, @flow-music-mcp/win32-arm64, or @flow-music-mcp/win32-x64). Do not pass --omit=optional or --no-optional.
To build from source, install Rust 1.88 (or newer) and Node.js. esbuild bundles ts/index.ts at compile time, so the binary does not need Node.js at runtime:
git clone https://github.com/ByteLandTechnology/flow-music-mcp.git
cd flow-music-mcp
npm ci
cargo build --releaseAdd the server to your MCP stdio client configuration (mcpServers):
{
"mcpServers": {
"flow-music": {
"command": "npx",
"args": ["-y", "@flow-music-mcp/cli", "--home", "/path/to/.flow-music-mcp"]
}
}
}Related MCP server: flow-studio
Documentation map
Guide | Focus | Key topics |
Tutorial | Install, configure a client, sign in, and make the first song | |
Explanation |
| |
Reference | CLI options, environment variables, MCP resources, and all MCP tools |
Tool overview
Domain | Tools | Purpose |
Session |
| Check the session, credits, and plan, and sign in with Chrome |
Creation (queued) |
| Make songs and lyrics, extend, replace, or cover songs, split stems, talk to the Producer agent, and make videos |
Queue control |
| Wait for jobs (45 s per call), stop jobs, or run failed jobs again |
Library |
| Manage songs, sessions, playlists, and Spaces, and upload audio or images |
Files |
| Download audio (m4a, wav, mp3), video, or cover art, and manage local files |
flow-music-mcp uses internal Google Flow Music interfaces. These interfaces can change without notice. Generation tools spend credits of your Google Flow Music plan.
Project status: the npm packages and GitHub releases are not published yet, so build from source for now.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for Producer/Riffusion AI music generation
Generate full songs with vocals, instrumentals and sound effects from text. One server for Suno, Google Lyria, Mureka, MiniMax, ACE-Step, YuE and ElevenLabs. Your agent can quote the credit cost before generating, start a song, wait for it to finish and return download links. Sign in with OAuth; optional daily credit caps; retries never charge twice.
AI image, video, voice and music generation over MCP, routed to Veo 3.1, Seedance 2.5 and more.
Generate AI music via the Lacuna Music API from MCP clients like Claude Desktop & Code.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants such as Claude Code, Codex, and Cursor to generate images and videos through Google Flow using a local, already signed-in Chrome session. It runs as a local MCP endpoint so assistants can submit generation jobs, manage them, and receive results using your own Flow subscription credits.2MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents from an MCP client to control Google Flow through a signed-in Chrome session, generating videos and images with Veo, Nano Banana, and Omni while managing projects, assets, scenes, characters, and shot lists with spending-approval guards and a sandboxed file vault.5MIT
- FlicenseNot gradedqualityAmaintenanceEnables MCP clients to search and manage playlists, library, catalog, discovery, playback, and the Up Next queue across macOS, Windows, and Linux.-
- FlicenseNot gradedqualityAmaintenanceEnables MCP clients to manage Apple Music playlists, library, catalog, discovery, playback, and the Up Next queue across macOS, Windows, and Linux using native Music.app, the Apple Music API, Safari, or Chrome engines.-