MCP server for TailwindCSS utility classes, documentation, and project assistance
npm install tailwindcss-mcp-serverA comprehensive Model Context Protocol (MCP) server that provides TailwindCSS utilities, documentation, conversion tools, and template generation capabilities. This server enables AI assistants to help with TailwindCSS development through intelligent tooling and real-time assistance.
get_tailwind_utilities - Retrieve TailwindCSS utility classes by category, property, or searchget_tailwind_colors - Access the complete TailwindCSS color palette with all shadesget_tailwind_config_guide - Get configuration guides for different frameworkssearch_tailwind_docs - Search TailwindCSS documentation with intelligent filteringinstall_tailwind - Generate installation commands and configurations for any frameworkconvert_css_to_tailwind - Convert traditional CSS to TailwindCSS utility classesgenerate_color_palette - Create custom color palettes with multiple shades from base colorsgenerate_component_template - Generate HTML component templates with TailwindCSS classesbash
npm install -g tailwindcss-mcp-server
`$3
`bash
npx tailwindcss-mcp-server
`$3
`bash
git clone
cd tailwindcss-mcp
npm install
npm run build
`⚙️ Configuration
$3
Add to your Claude Desktop configuration file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json#### Option 1: Using global installation
`json
{
"mcpServers": {
"tailwindcss-server": {
"command": "tailwindcss-server"
}
}
}
`#### Option 2: Using npx
`json
{
"mcpServers": {
"tailwindcss-server": {
"command": "npx",
"args": ["-y", "tailwindcss-mcp-server"]
}
}
}
`#### Option 3: Using local build
`json
{
"mcpServers": {
"tailwindcss-server": {
"command": "/path/to/tailwindcss-mcp/build/index.js"
}
}
}
`
$3
Add MCP Server using npx`bash
claude mcp add tailwindcss-mcp-server -- npx tailwindcss-mcp-server
`$3
Add to your
./windsurf/mcp_servers.json:
`json
{
"mcpServers": {
"tailwindcss-server": {
"command": "npx",
"args": ["-y", "tailwindcss-mcp-server"]
}
}
}
`$3
Add to your
.cursor/mcp.json:
`json
{
"mcpServers": {
"tailwindcss-server": {
"command": "npx",
"args": ["-y", "tailwindcss-mcp-server"]
}
}
}
`🛠️ Tool Reference
$3
####
get_tailwind_utilities
Retrieve TailwindCSS utility classes with flexible filtering options.Parameters:
-
category (optional): Filter by category (e.g., 'layout', 'typography', 'colors')
- property (optional): Filter by CSS property (e.g., 'margin', 'color', 'font-size')
- search (optional): Search term to find specific utilitiesExample Usage:
`typescript
// Get all layout utilities
get_tailwind_utilities({ category: "layout" })// Get margin-related utilities
get_tailwind_utilities({ property: "margin" })
// Search for flex utilities
get_tailwind_utilities({ search: "flex" })
`####
get_tailwind_colors
Access TailwindCSS color palette with complete shade information.Parameters:
-
colorName (optional): Specific color name (e.g., 'blue', 'red')
- includeShades (optional): Include all color shades (default: true)Example Usage:
`typescript
// Get all colors with shades
get_tailwind_colors({ includeShades: true })// Get specific color information
get_tailwind_colors({ colorName: "blue" })
`####
get_tailwind_config_guide
Get configuration guides and best practices for different frameworks.Parameters:
-
topic (optional): Configuration topic (e.g., 'installation', 'customization')
- framework (optional): Target framework (e.g., 'react', 'vue', 'nextjs')Example Usage:
`typescript
// Get React-specific configuration
get_tailwind_config_guide({ framework: "react" })// Get customization guides
get_tailwind_config_guide({ topic: "customization" })
`####
search_tailwind_docs
Search TailwindCSS documentation with intelligent filtering.Parameters:
-
query (required): Search query for TailwindCSS documentation
- category (optional): Filter by documentation category
- limit (optional): Limit number of results (default: 10)Example Usage:
`typescript
// Search for responsive design information
search_tailwind_docs({
query: "responsive design",
limit: 5
})// Search in specific category
search_tailwind_docs({
query: "dark mode",
category: "customization"
})
`$3
####
install_tailwind
Generate complete installation commands and configuration files for any framework.Parameters:
-
framework (required): Target framework ('react', 'nextjs', 'vue', 'vite', 'laravel', 'angular', 'svelte')
- packageManager (optional): Package manager ('npm', 'yarn', 'pnpm', 'bun') - default: 'npm'
- includeTypescript (optional): Include TypeScript configuration (default: false)Example Usage:
`typescript
// Install for Next.js with npm
install_tailwind({
framework: "nextjs",
packageManager: "npm"
})// Install for React with TypeScript and yarn
install_tailwind({
framework: "react",
packageManager: "yarn",
includeTypescript: true
})
`####
convert_css_to_tailwind
Convert traditional CSS to TailwindCSS utility classes with intelligent suggestions.Parameters:
-
css (required): CSS code to convert to TailwindCSS utilities
- mode (optional): Output format ('classes', 'inline', 'component') - default: 'classes'Example Usage:
`typescript
// Convert CSS to utility classes
convert_css_to_tailwind({
css: ".button { padding: 1rem; background-color: #3B82F6; color: white; }"
})// Convert with inline format
convert_css_to_tailwind({
css: ".card { margin: 16px; border-radius: 8px; }",
mode: "inline"
})
// Convert for @apply directive
convert_css_to_tailwind({
css: ".component { display: flex; justify-content: center; }",
mode: "component"
})
`####
generate_color_palette
Create custom color palettes with multiple shades from a base color.Parameters:
-
baseColor (required): Base color in hex, rgb, or hsl format
- name (required): Name for the color palette
- shades (optional): Array of shade values (default: [50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 950])Example Usage:
`typescript
// Generate brand color palette
generate_color_palette({
baseColor: "#6366F1",
name: "brand"
})// Generate custom shades
generate_color_palette({
baseColor: "rgb(59, 130, 246)",
name: "primary",
shades: [100, 300, 500, 700, 900]
})
// Generate from HSL
generate_color_palette({
baseColor: "hsl(217, 91%, 60%)",
name: "accent"
})
`####
generate_component_template
Generate HTML component templates with TailwindCSS classes and customization suggestions.Parameters:
-
componentType (required): Component type ('button', 'card', 'form', 'navbar', 'modal', 'alert', 'badge', 'breadcrumb')
- style (optional): Visual style ('minimal', 'modern', 'playful') - default: 'modern'
- darkMode (optional): Include dark mode support (default: false)
- responsive (optional): Include responsive design classes (default: true)Example Usage:
`typescript
// Generate a modern button
generate_component_template({
componentType: "button",
style: "modern",
responsive: true
})// Generate a modal with dark mode
generate_component_template({
componentType: "modal",
style: "minimal",
darkMode: true
})
// Generate a playful card component
generate_component_template({
componentType: "card",
style: "playful",
responsive: true
})
`🎯 Use Cases
$3
- Explore utility classes by category or property
- Understand the color system and naming conventions
- Get configuration examples for your framework
- Search documentation for specific concepts$3
- Convert legacy CSS to modern TailwindCSS utilities
- Get suggestions for unsupported properties
- Learn TailwindCSS equivalents for common CSS patterns
- Optimize existing stylesheets$3
- Generate custom color palettes that match your brand
- Create consistent component templates
- Export color variables for CSS or JavaScript
- Maintain design consistency across projects$3
- Get framework-specific installation guides
- Set up TailwindCSS with TypeScript support
- Configure build tools and development workflows
- Learn best practices for your tech stack🔧 Development
$3
- Node.js 18+
- npm, yarn, or pnpm$3
`bash
Clone the repository
git clone https://github.com/CarbonoDev/tailwindcss-mcp-server.git
cd tailwindcss-mcp-serverInstall dependencies
npm installBuild the project
npm run buildRun tests
npm testStart development with watch mode
npm run watch
`$3
`bash
Run all tests
npm testRun tests with coverage
npm run test:coverageRun tests in watch mode
npm run test:watchRun tests with UI
npm run test:ui
`$3
Use the MCP Inspector for debugging and development:
`bash
npm run inspector
``This will start the inspector and provide a URL for browser-based debugging.
- Real-time Documentation: Access up-to-date TailwindCSS documentation
- Intelligent Conversion: Convert CSS to TailwindCSS with accuracy and suggestions
- Framework Integration: Support for all major frontend frameworks
- Color Management: Advanced color palette generation with shade variants
- Template Generation: Ready-to-use component templates with customization options
- Performance Optimized: Efficient caching and service architecture
- Error Handling: Comprehensive error handling with helpful messages
- Type Safety: Full TypeScript implementation with proper typing
1. Fork the repository
2. Create a feature branch
3. Make your changes with tests
4. Ensure all tests pass
5. Submit a pull request
MIT License - see LICENSE file for details.
- TailwindCSS Official Documentation
- Model Context Protocol
- Claude Desktop
- MCP Inspector