# Introducing the Composables CLI and MCP server

> Start native apps with Composables UI without setting up every platform by hand.

Published 7 July 2026 by Alex Styl.

![Composables CLI creating a new native Compose app](https://composables.com/blog-assets/static/images/introducing-composables-cli.png)

Starting a native app with Compose still takes too much setup before you get to the first screen.

You have to wire platforms, Gradle modules, source sets, starter files, formatting, and dependencies before Composables UI even enters the picture.

The new **[Composables CLI](https://composables.com/ui/docs/cli.md)** gets a native app running with Composables UI already wired in.

**Composables CLI is a command-line tool for creating native apps and modules with Composables UI wired in from the start.**

## Start new native apps with a single command

Starting new native apps is a simple command away:

```bash
composables init
```

The CLI starts an interactive wizard and asks which platforms you want to target, what to name the app, and how you want it set up.

New apps come with Composables UI out of the box, along with Spotless setup for easy code formatting.

They also use the new project structure for Kotlin Multiplatform, with separate entry points for native apps and shared
application code.

## Create app and library modules in one go

The CLI can also add modules to existing Compose Multiplatform projects:

```bash
composables add module
```

App modules, library modules, the boring Gradle wiring around them.

You get the structure in place and move on with the feature.

## Search Composables UI docs from the terminal

The CLI can query the live Composables UI docs from the terminal:

```bash
composables docs search button
```

The `docs` command lets you go through the Composables UI docs with the same content as the website.

Even though this might not be the best way for humans to go through docs compared to [the visual docs on the website](https://composables.com/ui/docs.md),
it becomes unbelievably productive for agents.

## Help agents write Composables UI code

Composables UI is a new component library for Compose. LLMs will not be aware of its components and APIs for a few more months.

To speed things up, the CLI can run a Composables MCP server that gives your agent access to the same live docs while
it writes code.

Your agent can ask for component usage, installation steps, API references, and code examples without relying on stale
training data.

Based on [the editor and agent clients Compose developers told us they use](https://x.com/alexstyl/status/2073320199777038649), the CLI includes quick MCP setup for:

- Android Studio
- Antigravity
- Claude
- Codex
- Cursor
- Firebender
- OpenCode
- Zed

To configure a client, run:

```bash
composables mcp install --client <client>
```

For more details, [head over to the MCP documentation](https://composables.com/ui/docs/mcp.md).

## Install the CLI and create your first native app

Install the CLI from npm:

```bash
npm install -g composables-cli
```

Then run `composables init` to create your first native app.

Read the [Composables CLI documentation](https://composables.com/ui/docs/cli.md) for all commands and options.

If you use an agent, install the MCP server from the [MCP docs](https://composables.com/ui/docs/mcp.md).

---

## Tell us what breaks or feels slow

Try Composables UI, Compose Unstyled, and the CLI in a real project and let us know what gets in your way.

Join our GitHub community to share feedback, report issues and help shape future updates.

- Visit [Composables UI on GitHub](https://github.com/composablehorizons/composables-ui) for Composables UI and CLI feedback
- Visit [Compose Unstyled on GitHub](https://github.com/composablehorizons/compose-unstyled)

## Related reading

- [A New Default Project Structure for Kotlin Multiplatform](https://blog.jetbrains.com/kotlin/2026/05/new-kmp-default-structure/)