flowbite-mcp
The Flowbite MCP server enables AI assistants to access Flowbite's Tailwind CSS component library and provides AI-driven tools for UI creation and theme customization.
Core Capabilities:
Convert Figma designs to code - Transform Figma layers into code blocks by providing a Figma node URL (requires Figma personal access token)
Generate custom branded themes - Create tailored Flowbite theme CSS files from a brand color (hex format) and natural language instructions, with intelligent customization of colors, spacing, typography, border radius, and other theme variables
Access 60+ UI components - Browse and utilize Flowbite's complete component library including accordions, buttons, cards, modals, forms, typography elements, plugins, and theme documentation
Session management - Retrieve current session ID and context information
Deployment & Integration:
Dual transport modes - Run via stdio for CLI/desktop integration or HTTP server mode for production deployments
Production-ready - Docker support with health checks, monitoring, and configurable environment variables (Figma tokens, server port, host binding, CORS origins)
MCP-compatible - Integrates with Claude Desktop, Cursor, Windsurf, and other MCP-enabled clients
Planned integration for Figma to code conversion tool (currently on roadmap).
Provides access to the Flowbite library of 60+ Tailwind CSS UI components, forms, typography elements, and plugins, along with an AI-powered theme generator for creating custom branded designs from hex colors.
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., "@flowbite-mcp generate a responsive navbar component with a dark theme"
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.
An MCP server that enables AI assistants to access the Flowbite library of Tailwind CSS components—including UI elements, forms, typography, and plugins—while offering an intelligent theme generator for creating custom branded designs within AI-driven development environments.
MCP Features
Tools:
🎨 [NEW] Figma to code - Copy the Figma node url and generate code (video demo)
🎯 Theme file generator - Create custom branded themes from any branded hex color
Resources:
📦 60+ UI components - Complete access to the Flowbite UI components
Server:
🌐 Dual transport support - Standard I/O (stdio) for CLI or HTTP Streamable for server deployments
⚡ Production ready - Docker support with health checks and monitoring
Related MCP server: shadcn-ui MCP Server
Quickstart
Using NPX
The simplest way to use Flowbite MCP Server:
npx flowbite-mcpEnvironment variables
Currently you only need the Figma personal access token if you want to enable the Figma to code generation tool.
// other options
"env": {
"FIGMA_ACCESS_TOKEN": "YOUR_PERSONAL_FIGMA_ACCESS_TOKEN"
}You set this variable in your MCP client configuration file.
Integration examples
Use the following configuration examples to install the Flowbite MCP server in popular clients such as Cursor, Claude, Windsurf, and others.
Claude desktop
Update the claude_desktop_config.json file and add the following configuration:
{
"mcpServers": {
"flowbite": {
"command": "npx",
"args": ["-y", "flowbite-mcp"],
"env": {
"FIGMA_ACCESS_TOKEN": "YOUR_PERSONAL_FIGMA_ACCESS_TOKEN"
}
}
}
}Cursor editor
Update the mcp.json file and add the following configuration:
{
"mcpServers": {
"flowbite": {
"command": "npx",
"args": ["-y", "flowbite-mcp"],
"env": {
"FIGMA_ACCESS_TOKEN": "YOUR_PERSONAL_FIGMA_ACCESS_TOKEN"
}
}
}
}Windsurf editor
Update the mcp_config.json file and add the following configuration:
{
"mcpServers": {
"flowbite": {
"command": "npx",
"args": ["-y", "flowbite-mcp"],
"env": {
"FIGMA_ACCESS_TOKEN": "YOUR_PERSONAL_FIGMA_ACCESS_TOKEN"
}
}
}
}Glama.ai
Local Transport Modes
Standard I/O (stdio)
The default mode for local development and CLI integrations:
# Start in stdio mode (default)
node build/index.js
{
"mcpServers": {
"flowbite": {
"command": "node",
"args": ["/path/to/flowbite-mcp/build/index.js"],
"env": {
"FIGMA_ACCESS_TOKEN": "YOUR_PERSONAL_FIGMA_ACCESS_TOKEN"
}
}
}
}Learn how to get the Figma personal access token to enable the Figma to code generation tool.
HTTP server
HTTP-based transport for production and multi-client scenarios:
node build/index.js --mode http --port 3000This will make the MCP server available at 'http://localhost:3000/mcp'.
Local development
# Clone the repository
git clone https://github.com/themesberg/flowbite-mcp.git
cd flowbite-mcp
# Install dependencies
npm install
# Build the project
npm run build
# Run in stdio mode (for Claude Desktop, Cursor)
npm start
# Run inspector
npm run start inspector
# Run in HTTP server mode (for production/multi-client)
MCP_TRANSPORT_MODE=http npm startProduction deployment (HTTP Mode)
For production servers with multiple clients:
# Using npx
npx flowbite-mcp --mode http --port 3000
# Using Docker Compose
docker-compose up -d
# Health check
curl http://localhost:3000/healthHosting variables
Configure the server behavior with these environment variables:
# Transport mode: stdio (default) or http
MCP_TRANSPORT_MODE=http
# Server port for HTTP mode
MCP_PORT=3000
# Host binding for HTTP mode
MCP_HOST=0.0.0.0
# CORS origins (comma-separated)
MCP_CORS_ORIGINS=http://localhost:3000,https://myapp.comDocker Configuration
The project includes a production-ready Docker setup with multi-stage builds for optimal performance.
Quickstart with Docker
# Build and run with Docker Compose (recommended)
docker-compose up -d
# Check health
curl http://localhost:3000/health
# View logs
docker-compose logs -f
# Stop
docker-compose downMCP inspector
Use the MCP Inspector for interactive debugging:
npm run inspectorLogging
Check server logs for detailed information:
# stdio mode logs to console
node build/index.js
# HTTP mode includes HTTP request logs
MCP_TRANSPORT_MODE=http node build/index.jsFile structure
flowbite-mcp/
├── src/
│ ├── index.ts # Main server entry point
│ └── server-runner.ts # Express HTTP Streamable transport
├── data/
│ ├── components/ # 60+ component markdown files
│ ├── forms/ # Form component documentation
│ ├── typography/ # Typography elements
│ ├── plugins/ # Plugin documentation
│ ├── theme.md # Theme variable reference
│ └── quickstart.md # Getting started guide
├── build/ # Compiled JavaScript output
├── package.json
├── tsconfig.json
└── README.mdContributing
Contributions are welcome! Please feel free to submit a Pull Request.
Fork the repository
Create your feature branch (
git checkout -b feature/AmazingFeature)Commit your changes (
git commit -m 'Add some AmazingFeature')Push to the branch (
git push origin feature/AmazingFeature)Open a Pull Request
License
This project is licensed under the MIT License License - see the LICENSE file for details.
Credits
Flowbite - For the amazing Tailwind CSS component library
Anthropic - For the Model Context Protocol specification
Tailwind CSS - For the utility-first CSS framework
Resources
Roadmap
Complete component resource access
AI-powered theme generator
Dual transport support (stdio + HTTP)
Flowbite Pro blocks integration (with license authentication)
Figma to code conversion tool
Enhanced theme customization options
Component search and filtering
Real-time component preview generation
Available Tools
2 toolsconvert-figma-to-codeA
Fetches a Figma node and its rendered image from the Figma API and converts it to a code block. Requires FIGMA_ACCESS_TOKEN environment variable to be set.
Inputs: figmaNodeUrl (required).
generate-themeA
Generates a custom Flowbite theme CSS file based on a brand color (hex format) and user instructions. The AI will intelligently analyze the instructions and customize ALL theme variables (border radius, spacing, colors, typography, etc.) to match the desired aesthetic. This tool creates color shades and variations, adapting the entire theme system to match your brand identity.
Inputs: brandColor (required), instructions (required), fileName.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have completely different purposes: one converts Figma designs to code, the other generates a theme from a brand color. There is no overlap or ambiguity.
Both tools use snake_case and follow a verb-object pattern, though 'convert-figma-to-code' is more detailed than 'generate-theme'. The inconsistency is minor.
With only two tools, the surface feels thin for a design-to-code and theme generation server. However, the scope is narrow enough that the count is borderline acceptable.
The tools cover the core workflows of converting a design and generating a theme. Missing features like theme validation or export are minor gaps for the stated purpose.
Maintenance
Related MCP Connectors
Official MCP server for Lovable, the AI-powered full-stack app builder.
The official MCP server for Capawesome documentation and Capawesome Cloud.
Unofficial MCP server for the Capacitor documentation, plugin list and blog.
Official MCP server for Certifier to issue, manage, and track certificates and badges.
Related MCP Servers
- AlicenseAqualityDmaintenanceAllow your AI coding agents to access Figma files & prototypes directly. You can DM me for any issues / improvements: https://x.com/jasonzhou1993 1. Access all figma pages 2. Access all figma components 3. Access figma prototype flows352 PyPI67MIT
- AlicenseAqualityDmaintenanceProvides reference information for shadcn/ui components through a Model Context Protocol server that helps AI assistants access component documentation and examples.4551 npmMIT
- AlicenseBqualityDmaintenanceHugeicons MCP Server is a TypeScript based server that provides integrated tools and resources for the Hugeicons icon library, supporting icon search, retrieval, and usage guides for multiple platforms.52Apache 2.0
- AlicenseNot gradedqualityDmaintenanceThis MCP server provides tools to install and manage shadcn/ui components directly from AI coding agents.2MIT