figma-flow
Integrates with Figma through a local plugin to draw automatically laid-out flowcharts directly onto the Figma canvas, including labeled arrows, standard flowchart shapes sized to fit their labels, one frame per chart, and safe cleanup of previously drawn charts.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@figma-flow Draw a flowchart of our password reset process"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
figma-flow-mcp
Describe a process to Claude and get a clean, automatically laid-out flowchart drawn straight onto your Figma canvas.

How it works
flowchart LR
claude["Claude<br/>(Claude Code or Claude Desktop)"] -- "MCP over stdio" --> server["figma-flow MCP server<br/>validation + dagre layout"]
server -- "WebSocket<br/>ws://localhost:3055" --> plugin["figma-flow Figma plugin"]
plugin --> canvas["Figma canvas"]Claude calls
create_flowchartwith the chart's structure only: nodes, edges and labels, no coordinates.The MCP server validates it. It then asks the plugin to measure every label in Figma, so each shape fits its text.
The server lays the chart out top to bottom with dagre.
The plugin draws the shapes, arrows and labels in a new frame.
The plugin's window holds the WebSocket connection, so it stays open while you work.
Related MCP server: Claude Talk to Figma MCP
Features
Plain-language charts. Describe a process and Claude picks the steps, decisions and branches.
Automatic layout. Claude never sends coordinates; dagre arranges the chart top to bottom, including loops.
Standard flowchart shapes, each sized to fit its label:
pills for
startandendrectangles for
processstepsdiamonds for
decisionsparallelograms for
input_output
Labeled arrows, such as "Yes" and "No" on decision branches.
One frame per chart, named after its title and placed to the right of earlier charts. The viewport zooms to it.
Clear errors. Invalid input names the bad node or edge, and the tools tell you when the plugin isn't connected.
Safe cleanup.
clear_canvasremoves only what figma-flow drew.Local only. The WebSocket bridge listens on
127.0.0.1and nothing leaves your machine.
Arrows are vector paths, so they don't follow a shape you move by hand. Figma's connector API only exists in FigJam.
Tools
Tool | What it does | Example prompt |
| Draws a flowchart from a title, nodes and edges | "Draw a flowchart of a password reset flow" |
| Removes every chart figma-flow drew on the current page | "Clear the flowcharts from this page" |
| Draws a sample login flow to check the setup | "Draw the demo flowchart" |
| Reports whether the Figma plugin is connected | "Is the Figma plugin connected?" |
| Checks that the MCP server is running | "Ping the figma-flow server" |
Requirements
Node.js 18 or newer
The Figma desktop app. Development plugins can't be imported in the browser.
Setup
Clone the repository
git clone https://github.com/Sanil-Gokarn/figma-flow-mcp.git cd figma-flow-mcpInstall dependencies
npm installBuild the server and the plugin
npm run buildImport the plugin into Figma. In the Figma desktop app, open a design file. Choose Plugins → Development → Import plugin from manifest… and pick
plugin/manifest.json.Run the plugin. Choose Plugins → Development → figma-flow. A small window opens; keep it open. It shows Connected once Claude's figma-flow server is running, and retries every 2 seconds until then.
Connect Claude.
Claude Code: start
claudein the repository folder. The repo's.mcp.jsonregisters thefigma-flowserver; approve it when asked./mcpshould list it as connected.Claude Desktop: add the server to
claude_desktop_config.jsonusing the absolute path to your clone, then restart Claude Desktop:{ "mcpServers": { "figma-flow": { "command": "node", "args": ["/absolute/path/to/figma-flow-mcp/dist/index.js"] } } }
Ask for a chart, for example: "Draw a flowchart for making a cup of tea."
Changing the port
The bridge listens on port 3055. To use another port, set PORT in the server's MCP config:
{
"mcpServers": {
"figma-flow": {
"command": "npx",
"args": ["tsx", "server/index.ts"],
"env": { "PORT": "3056" }
}
}
}Then change the port in two places in the plugin, and reopen the plugin in Figma:
SERVER_URLinplugin/ui.htmldevAllowedDomainsinplugin/manifest.json
Troubleshooting
The plugin shows Disconnected, or a tool says "The Figma plugin isn't connected"
Keep the plugin window open. Closing it drops the connection.
Check that Claude has the server loaded by asking "Is the Figma plugin connected?".
get_statusalso shows the port the server listens on.If that port isn't 3055, your environment probably sets
PORTfor something else. Add"env": { "PORT": "3055" }to the figma-flow entry in your MCP config.Look for WebSocket errors in Figma's console: Plugins → Development → Show/Hide console.
"Port 3055 is already in use"
Another Claude session is already running figma-flow. This could be a second Claude Code window in this folder, or Claude Desktop. Only one session can talk to Figma at a time.
Close the other session, then reconnect figma-flow from /mcp or start a new session. To see what holds the port:
# macOS / Linux
lsof -i :3055# Windows
netstat -ano | findstr :3055figma-flow is missing from /mcp
Start Claude Code from the repository folder.
.mcp.jsonis project-scoped, so Claude Code only loads it there.Approve the server when Claude Code asks. If you declined it earlier, run
claude mcp reset-project-choicesand restart Claude Code.Make sure
npm installhas run. Then runnpm run devto see any startup errors directly; it waits for MCP input, and Ctrl+C stops it.The first
npxstart can be slow. If the server timed out, reconnect it from/mcp.
Development
npm run dev # run the server from source with tsx
npm run build # compile server/ to dist/ and plugin/code.ts to plugin/code.js
npm run check # type-check the server and the pluginserver/: the MCP server.index.tsholds the tools,bridge.tsthe WebSocket bridge,layout.tsthe dagre layout andflowchart.tsthe input schema and validation.plugin/: the Figma plugin.code.tsdraws on the canvas;ui.htmlholds the WebSocket connection.
Roadmap
Swimlanes
Mermaid import
Editing existing charts
License
MIT © Sanil Gokarn
Available Tools
5 toolsclear_canvasClear canvasA
Remove every flowchart and shape the figma-flow plugin drew on the current Figma page. Everything else on the page is left alone.
Inputs: no named parameters.
create_flowchartCreate flowchartA
Draw a flowchart in the open Figma file.
Send only the structure: nodes (id, label, type) and edges (from, to, optional label). Never send coordinates or sizes. The server lays the chart out top to bottom, and the plugin sizes each shape to fit its label.
How to model a flow:
Begin with one "start" node. End every path at an "end" node.
Use "process" for actions and "input_output" for data going in or out, such as user input, a message shown to the user, or reading a file.
Every yes/no question or branch point is a "decision" node. Phrase its label as a question ("Password valid?") and give each outgoing edge a label ("Yes", "No").
Loops are fine: point an edge back to an earlier node.
Each call adds a new frame, named after the title, to the right of earlier charts. The figma-flow plugin must be running in Figma (check with get_status).
Inputs: edges (required), nodes (required), title (required).
draw_demo_flowchartDraw demo flowchartA
Draw a sample login flowchart in the open Figma file. Useful to check the setup works end to end.
Inputs: no named parameters.
get_statusGet statusA
Report whether the figma-flow Figma plugin is connected to this server.
Inputs: no named parameters.
pingPingA
Check that the figma-flow MCP server is running. Returns 'pong'.
Inputs: message.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
create_flowchart, draw_demo_flowchart, and clear_canvas are clearly distinct in purpose. The main overlap is between ping and get_status, which both serve as health/connectivity checks, though get_status specifically reports plugin connection state.
All names use snake_case consistently, which is good. However, the convention is not fully uniform: 'ping' is a bare verb, 'get_status' uses verb_noun, and the drawing tools mix 'draw_' and 'create_' as prefixes for similar operations.
Five tools is well-scoped for a lightweight Figma flowchart plugin: health checks, connection status, chart creation, demo creation, and canvas clearing. Each tool has a clear role and none feels redundant.
The surface covers creating and clearing flowcharts, plus setup checks, but lacks operations to list, update, or delete individual existing flowcharts. The only removal tool clears the entire canvas, which is a notable gap for repeated editing workflows.
Related MCP Connectors
Turn calls and notes into process flow diagrams in Claude, ChatGPT, VS Code, Cursor, and Teams.
Make editable flowcharts, process charts, funnels, timelines and data models from plain language.
Compare Figma designs against live websites and get visual + content QA reports, from inside Claude.
Flett is a shared online whiteboard. Connect it to Claude, ChatGPT or Cursor and the AI draws straight onto your boards: flowcharts, mind maps and architecture diagrams made of shapes and arrows, documents, slides and designed pages, charts, maps and files. Everyone on the board sees it appear live and can move, edit and comment on everything, then present it or export it to PNG, PDF, PowerPoint or HTML. Sign-in is OAuth; reading boards is free.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables Claude Desktop and other AI tools to interact directly with Figma, allowing for powerful AI-assisted design capabilities through natural language commands.92842 npm680MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants like Claude Desktop to interact directly with Figma, allowing natural language commands to create, modify, and analyze designs including shapes, text, components, and layouts in real-time.MIT
- AlicenseNot gradedqualityBmaintenanceEnables Claude to read and manipulate Figma documents in real-time through 62 operations including creating shapes, modifying styles, managing components, and exporting assets via a WebSocket bridge to a Figma plugin.82 npm85MIT
- AlicenseBqualityBmaintenanceEnables Claude to connect to Figma without a paid plan, offering auto-connect and 100+ tools for document manipulation, design system sync, and code-to-Figma conversion.10026 npm1MIT