# Use Flowmaps inside Claude

> Connect Claude to Flowmaps and you can plan and build by simply chatting. No commands to remember: Claude looks at your boards, reads the build instruction

Canonical: https://flowmaps.app/docs/claude-connection

Build

# Use Flowmaps inside Claude

Last updated: October 2026

Connect Claude to Flowmaps and you can plan and build by simply chatting. No commands to remember: Claude looks at your boards, reads the build instructions, builds the feature, and keeps your board up to date. It works in the Claude app (web, desktop and mobile) and in Claude Code.

## Claude app or Claude Code?

|                                                              | Claude app (web, desktop, phone)            | Claude Code (in your project folder) |
| ------------------------------------------------------------ | ------------------------------------------- | ------------------------------------ |
| See your ventures and what's Ready                           | ✅                                           | ✅                                    |
| Add ideas to a mind map                                      | ✅                                           | ✅                                    |
| Read and explain build instructions                          | ✅                                           | ✅                                    |
| **Write the code** and move cards to In Progress and Shipped | ❌ It can't reach the files on your computer | ✅                                    |

So: **plan in the Claude app, build in Claude Code.** Ask the Claude app to build something and it tells you the same. Connect both if you can; they use the same Flowmaps account.

**Using the Claude desktop app?** It has both: a normal chat for planning, and a **Code** tab (the `</>` icon, top left) that is Claude Code. Build from the Code tab.

## What you can ask

- _"What can I build from Flowmaps?"_ Claude shows the features that are Ready or being built.
- _"Build the sign-up feature."_ (in Claude Code) Claude fetches its build instructions, moves it to **In Progress**, and starts building in your project.
- _"It works, finish it."_ (in Claude Code) Claude adds the work to your main project (after asking) and moves the feature to **Shipped**.
- _"Add push notifications as an idea to my LayerloopsData mind map."_ A new card appears on your mind map. If it touches something risky, like payments or personal data, it gets a [flag](https://flowmaps.app/docs/flags).

What can I build from Flowmaps?

In Pawstep, **Customers pay in the app** is ready. It has a security flag: let Stripe handle card details. Shall I build it?

## Connect the Claude app (once)

1. In Flowmaps, open **Settings → Use Flowmaps inside Claude** and copy the address (`https://flowmaps.app/api/mcp`).
2. In Claude (claude.ai or the desktop app), open **Settings → Connectors** and click **Add custom connector**. Name it _Flowmaps_, paste the address and click **Add**.
3. Click **Connect**. Flowmaps opens in your browser: check that it's your account and click **Allow Claude**.
4. Start a new chat and ask: _"What can I build from Flowmaps?"_

Once it's connected, it also works in the Claude mobile app.

## Connect Claude Code (once)

Using the **Code** tab in the Claude desktop app, or signed in to Claude Code with the same Claude account you connected above? Then Flowmaps is usually there already: type `/mcp` in Claude Code and look for _Flowmaps_. If it's listed as connected, skip this section.

1. Paste this in a terminal and press Enter (or paste it in a Claude Code chat with _"Please run this command:"_ in front): `claude mcp add --scope user --transport http flowmaps https://flowmaps.app/api/mcp`
2. Start Claude Code, type `/mcp`, pick _flowmaps_ and choose **Authenticate**. Your browser opens Flowmaps: click **Allow Claude**.
3. Ask: _"What can I build from Flowmaps?"_

## Build your first feature

Building happens on your own computer, in a folder for your project. You set this up once per project:

1. **Make a folder** for your project, for example _Documents/my-app_. It can be empty: Claude Code fills it with your app.
2. **Open it in Claude Code.** Easiest: in the [Claude desktop app](https://claude.ai/download), click the **Code** tab (`</>`, top left) and choose your folder. Already use VS Code? Install the [Claude Code extension](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code), open the folder (_File → Open Folder_) and sign in with the same Claude account.
3. **Check that Flowmaps is there**: type `/mcp`. Not listed? Follow _Connect Claude Code_ above.
4. **Ask**: _"Build Owners can sign up from Flowmaps"_, with the name of your Ready feature. The Setup guide has this sentence ready to copy. Ask in the Code tab, not a normal chat: a chat can't reach your files.

Claude Code fetches the build instructions, moves the card to **In Progress**, and starts building. In an empty folder it first sets up the project, and it may ask to turn on git (a history of your changes): say yes, so every feature is kept separate. For the next feature, open the same folder and ask again.

Want to build more than one feature in one go? See [Build several features at once](https://flowmaps.app/docs/build-several).

Keep a safe copy of everything you build: [Save your work on GitHub](https://flowmaps.app/docs/save-your-work) shows how, step by step, including saving every night by itself.

## Import an existing project

In your project folder, ask Claude Code _"Import this project into Flowmaps"_. It reads your code, shows you the features it found and creates the venture once you agree. See [Import a project you're already building](https://flowmaps.app/docs/import-project).

## What Claude can and can't do

When you click **Allow Claude**, Claude can work with the ventures in every workspace where you're an Owner or Editor: see what's Ready, read build instructions and skills, add ideas, and move features to In Progress and Shipped. It can't see your API key, delete anything or change your team.

Planning in ChatGPT instead? See [Use Flowmaps inside ChatGPT](https://flowmaps.app/docs/chatgpt-connection).

Other AI tools without a Connect button can use an access token instead: **Settings → Use Flowmaps inside Claude → Connecting another AI tool**.

## Disconnect

Claude appears in **Settings → Terminal** under connected computers as _Claude (MCP)_. Click **Disconnect** to remove its access right away. To connect again, click **Connect** in Claude.

## Good to know

- Claude only sees ventures in **your** workspaces, through the same secure connection as the [flowmaps command](https://flowmaps.app/docs/command-line). What it does shows up in [Activity](https://flowmaps.app/docs/activity) as _via Claude_.
- Claude asks before changing your board, and only marks a feature Shipped after you've confirmed it works.
- Flags are automatic warnings, not legal advice.

## Example

> **You:** What can I build from Flowmaps?
> 
> **Claude:** In LayerloopsData, "Users sign up and save credit cards" (v0.2.0) is ready. Shall I build it?
> 
> **You:** Yes.
> 
> **Claude:** I'll work on a separate copy of your project (branch `flowmaps/v0.2.0-users-sign-up-and-save-credit-cards`) and move the feature to In Progress. First the database part…

[← PreviousBuild prompts](https://flowmaps.app/docs/build-prompts)[Next →Use Flowmaps inside ChatGPT](https://flowmaps.app/docs/chatgpt-connection)

Try it on your own app idea

Flowmaps is free to start, and new accounts get 7 days of Pro. No credit card.

[Start free](https://flowmaps.app/login?new=1)
