๐ Available in: ํ๊ตญ์ด (Korean) | ๆฅๆฌ่ช (Japanese) | ็ฎไฝไธญๆ (Simplified Chinese) | ็น้ซไธญๆ (Traditional Chinese)
## ๐ฅ Short Video Demo
Showcased almost all the features of Figma Flutter MCP with real figma design.
- English: https://youtu.be/lJlfOfpl2sI
- Urdu/Hindi: https://youtu.be/mepPWpIZ61M
## ๐ [Getting Started](docs/getting-started.md)
You may explore the detailed [getting started](docs/getting-started.md) docs or the [demo video](https://youtu.be/lJlfOfpl2sI) as quick-start. As its a First Release hence there's a lot of room for improvements so you can checkout the [issues](https://github.com/mhmzdev/figma-flutter-mcp/issues) to see what else there's to work or to improve.
## ๐ How it works | [Details Here](docs/figma-flutter-mcp.md)
1. [Components/Widgets](src/extractors/components/)
- โ
Extract Figma node data: Layout, styling, dimensions, colors, text content, etc.
- โ
Analyze structure: Child elements, nested components, visual importance
- โ
Provide guidance: Suggest Flutter widgets and implementation patterns
- โ NOT generating actual Flutter code files
2. [Screens](src/extractors/screens/)
- โ
Extract screen metadata: Device type, orientation, dimensions
- โ
Identify sections: Header, footer, navigation, content areas
- โ
Analyze navigation: Tab bars, app bars, drawers, navigation elements
- โ
Provide Scaffold guidance: Suggest Flutter screen structure
- โ NOT generating actual Flutter screen
Since its just helping AI write Flutter code so it means the better your prompt will be the better results you'll get.
## ๐ ๏ธ Usage
Following steps shows a minimal usage and setup instructions:
### ๐ Figma API Key
You will need to create a Figma access token to use this server. Instructions on how to create a Figma API access token can be found [here](https://help.figma.com/hc/en-us/articles/8085703771159-Manage-personal-access-tokens).
### ๐น MCP in Cursor
Once you've the FIGMA API KEY, you can setup the MCP in cursor as follows:
1. Press CMD + Shift + P (Ctrl on Windows)
2. Type "Open MCP Settings"
3. Click on "Add new MCP"
4. Paste the below json object
#### MacOS/Linux
```
{
"mcpServers": {
"Figma Flutter MCP": {
"command": "npx",
"args": ["-y", "figma-flutter-mcp", "--figma-api-key=YOUR-API-KEY", "--stdio"]
}
}
}
```
#### Windows
```
{
"mcpServers": {
"Figma Flutter MCP": {
"command": "cmd",
"args": ["/c", "npx", "-y", "figma-flutter-mcp", "--figma-api-key=YOUR-API-KEY", "--stdio"]
}
}
}
```
> NOTE: If you've installed this MCP as `npm` package make sure to keep it updated to latest version. Sometimes, it caches the old version and keep showing you error like "Not being able to use tool call" or "Figma API key setup is not working" etc.
### ๐ Quick Start for Local Testing
#### Prerequisites
- Node.js 18+
- Figma API Key (Access Token)
- Cursor AI IDE with MCP support
- Flutter SDK
For quick local testing, you can run the server via HTTP instead of stdio:
```bash
# Clone and setup
git clone 
```
"Design this intro screen from the figma link 
## โ ๏ธ Disclaimers
- **Use Case**: At this stage, its highly recommend to NOT use it to develop scalable apps rather try and play it with MVPs, smaller and explanatory tasks.
- **Figma Design**: Since we're using Figma's API to fetch the node and its details, so the better design you have the more better it will interpret for the AI to consume i.e. auto layouts, frame usage over group usage, consistently aligned across the board.
- **Rate limiting**: Heavy usage may trigger Figma rate limits (e.g., HTTP 429). The server includes retry with backoff, but it does not bypass Figma limits. If you encounter rate limits, wait a few minutes and reduce the request volume.
## ๐๐ผ Acknowledgments
I came across [Figma Context MCP](https://github.com/GLips/Figma-Context-MCP) by [Graham Lipsman](https://x.com/glipsman) that sparks this motivation for me to develop Figma to Flutter explicitly having features like:
- Assets exports
- Colors and Theme setups
- Widget tree and full screen building
Others coming soon...
## ๐งฑ Other framworks
If you want to develop this for React, Angular, React Native, Vue or any other framework. I've added a detailed doc [Figma Framework MCP](docs/figma-framework-mcp.md) that you can explore and get started. Meanwhile I'll maintain a list here if someone's already doing this for framework specific Figma's MCP servers.
- ...
- ...
## ๐ License
This project is licensed under the MIT License - see the [LICENSE](LICENSE.md) file for details
## ๐โโ๏ธ Author
#### Muhammad Hamza
[](https://www.linkedin.com/in/mhmzdev)
You can also follow my GitHub Profile to stay updated about my latest projects:
[](https://github.com/mhmzdev)
If you liked the repo then kindly support it by giving it a star โญ!
Copyright (c) 2025 MUHAMMAD HAMZA
---
**Built with โค๏ธ for designers and developers who want to bridge the gap between design and code.**