# Flow Music (fmusic)

> Flow Music (fmusic) is an MCP server for design and media. Unofficial CLI and MCP server to generate, remix and stem-split songs with Flow Music. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, macOS, Linux, Windows
- **Repository:** https://github.com/jvanleeuwen4/flowmusic-cli
- **MCP Registry name:** io.github.JvanLeeuwen4/flowmusic-cli
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media)
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add flowmusic-cli -- uvx flowmusic-cli
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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.

## Alternatives

- [gflow-cli](https://ai-powered.com/mcp/gflow-cli): gflow-cli is an open-source MCP server for design and media.
- [Google Flow Agent MCP Server by useapi.net (third-party)](https://ai-powered.com/mcp/google-flow-agent-mcp-server-by-useapi-net-third-party): Google Flow Agent MCP Server by useapi.net (third-party) is an MCP server for design and media.
- [Audio Studio](https://ai-powered.com/mcp/audio-studio): Audio Studio is an open-source MCP server for design and media.
- [Daydream](https://ai-powered.com/mcp/daydream): Daydream is a freemium MCP server for design and media.
- [Music Studio](https://ai-powered.com/mcp/music-studio): Music Studio is a free MCP server for design and media.
- [ACE Music MCP Server by useapi.net (third-party)](https://ai-powered.com/mcp/ace-music-mcp-server-by-useapi-net-third-party): ACE Music MCP Server by useapi.net (third-party) is an MCP server for design and media.
- [Flowctory](https://ai-powered.com/mcp/flowctory): Flowctory is a freemium MCP server for design and media.
- [Pure BPM](https://ai-powered.com/mcp/pure-bpm): Pure BPM is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/flow-music-fmusic
