Tailwind Shades
Generate full Tailwind CSS palettes from any color, in the project's own format
- Pricing
- Open source
- Platforms
- CLI, vscode, Web
- Runs
- Locally or Remotely
- Version
- 1.6.0
- Listing updated
- 2 days ago
About Tailwind Shades
Tailwind Shades is an open-source MCP server for developer tools. It can run locally on your machine or as a hosted remote server.
Agents tend to guess Tailwind shades or add a single brand line instead of a palette. This server hands them a real 50 to 950 scale in OKLCH, where the color you supply stays exactly as given and the other shades follow Tailwind's own colors. It covers Tailwind v4, v3, v2 and v1.
The generate_palette tool accepts any CSS color and outputs code in the right shape, such as a v4 @theme block or a v3 config, plus the shades, the shade holding the input and the closest Tailwind color as structured data. Its output opens with a comment of readable class pairs that pass WCAG AA at 4.5:1, so a red brand gets bg-brand-600 text-white instead of a failing combination. Extra output modes cover runtime-picked colors and Shopify themes. find_closest_tailwind_color maps a color such as #db4d53 to red-500 and says whether the difference is visible.
It can run remotely with no key, or locally over stdio with npx, which keeps everything on your machine. All five tools are read-only. The same engine powers a VS Code extension, a CLI and the website.
Install
Run in a terminal
claude mcp add --transport http tailwindshades https://tailwindshades.bourhaouta.com/mcpAdd to Settings → Connectors → Add custom connector
https://tailwindshades.bourhaouta.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"tailwindshades": {
"url": "https://tailwindshades.bourhaouta.com/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"tailwindshades": {
"type": "http",
"url": "https://tailwindshades.bourhaouta.com/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"tailwindshades": {
"serverUrl": "https://tailwindshades.bourhaouta.com/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"tailwindshades": {
"type": "http",
"url": "https://tailwindshades.bourhaouta.com/mcp"
}
}
}Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- generate_palette
- A full 50 to 950 palette from one color, ready to paste.
- find_closest_tailwind_color
- The Tailwind shade that looks most like a color, with the distance and whether the difference is visible.
What it does
- Full palettes
- A 50 to 950 scale computed in OKLCH from one input color.
- Version aware
- Targets Tailwind v4, v3, v2 and v1 with matching formats.
- Readable pairs
- Comments list class combinations that pass WCAG AA.
- Closest Tailwind color
- Maps any color to the nearest built-in shade and reports the distance.
- Runtime color output
- Modes for colors chosen at runtime and for Shopify theme settings.
- Remote or local
- Streamable HTTP with no key, or a local stdio package.
Good for
- Add a brand color to a Tailwind theme with a proper scale
- Pick accessible button and badge classes for a brand color
- Find which built-in Tailwind color matches a hex value
- Generate per-tenant color variables for a white-label app
- Convert a palette between Tailwind versions
Pricing
Open source
Free; no API key
Prices change. Check tailwindshades.bourhaouta.com before you buy.
Tailwind Shades FAQ
Does the input color stay unchanged?
Yes. It is kept exactly and the other shades are derived around it.
Which Tailwind versions work?
v4, v3, v2 and v1.
Do I need a key?
No. The remote endpoint needs no API key, and the local package runs with npx on Node.js 20 or later.
Are the tools read-only?
Yes, all five are read-only.
Is Tailwind Shades free?
Yes. Tailwind Shades is open source, so you can use and self-host it for free.
How do I add Tailwind Shades to Claude Code?
Run this command in your terminal: claude mcp add --transport http tailwindshades https://tailwindshades.bourhaouta.com/mcp
What are the best alternatives to Tailwind Shades?
The closest alternatives to Tailwind Shades are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.
Alternatives to Tailwind Shades

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory