Skip to content
MCP server

Flow Music (fmusic)

Unofficial CLI and MCP server to generate, remix and stem-split songs with Flow Music

Runs locally
Install
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.2.0
Listing updated
4 days ago

Similar MCP servers

About Flow Music (fmusic)

Flow Music (fmusic) is an MCP server for design and media. It runs locally on your machine and is started by your AI client.

fmusic is a command-line client and MCP server for Google's Flow Music (Lyria) at flowmusic.app. You sign in once with your own Google account through a browser, after which it works without one: describe a song and a few minutes later you get a WAV file and a JSON file of details. It is unofficial, not affiliated with Google, and can break when the site changes.

Beyond generating from a prompt it supports your own lyrics, instrumentals, continuing a conversation with the co-producer to tweak or extend a take, restyling your own audio, splitting stems into vocals, drums, bass and other, and listing, downloading, renaming or deleting clips. An experimental direct mode sends the prompt to the song model as-is.

A game-audio option cuts and crossfades a seamless loop, saved as OGG and written as loop points in the WAV, and an existing clip can be looped without credits. It uses your own account's credits. Install is through uv or pipx, with a Claude Code plugin and a standard uvx MCP config.

Install

Run in a terminal

claude mcp add flowmusic-cli -- uvx flowmusic-cli

Add to claude_desktop_config.json

{
  "mcpServers": {
    "flowmusic-cli": {
      "command": "uvx",
      "args": [
        "flowmusic-cli"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "flowmusic-cli": {
      "command": "uvx",
      "args": [
        "flowmusic-cli"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "flowmusic-cli": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "flowmusic-cli"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "flowmusic-cli": {
      "command": "uvx",
      "args": [
        "flowmusic-cli"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "flowmusic-cli": {
      "command": "uvx",
      "args": [
        "flowmusic-cli"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

What it does

Prompt to song
Generate a WAV and JSON from a text description.
Conversation edits
Continue a conversation to speed up, extend or remix a take.
Stem splitting
Separate vocals, drums, bass and other.
Seamless loops
Create loopable OGG files and WAV loop points for game engines.
Agent friendly
Every command accepts --json with stable exit codes.
Multiple profiles
Switch between several Google accounts.

Good for

  • Generate background music from a description
  • Make looping game soundtracks for Godot or Unity
  • Separate a song into stems
  • Script music generation from an AI agent

Pricing

Pricing unknown

Uses your own Flow Music credits

Flow Music (fmusic) FAQ

Is this an official Google tool?

No. It is unofficial and not affiliated with or supported by Google.

What do I need?

Python 3.10+, Chrome or Edge for sign-in, and a Google account with Flow Music access.

Does it use my credits?

Yes, it uses your own account and credits.

Where are files saved?

By default in ~/Music/flowmusic-cli/<date>/.

How do I add Flow Music (fmusic) to Claude Code?

Run this command in your terminal: claude mcp add flowmusic-cli -- uvx flowmusic-cli

What are the best alternatives to Flow Music (fmusic)?

The closest alternatives to Flow Music (fmusic) are gflow-cli, Google Flow Agent MCP Server by useapi.net (third-party), Audio Studio, Daydream and Music Studio.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers