tailwindcss-docs-mcp

Local semantic search for Tailwind CSS documentation via Model Context Protocol. Downloads the official docs, embeds them locally, and gives your assistant real search over real documentation. No API keys, no external services, everything on your machine. Just Node.js 18+.

Getting Started

Claude Code

claude mcp add tailwindcss-docs-mcp -- npx -y tailwindcss-docs-mcp

Other MCP clients (Claude Desktop, Cursor, Windsurf, etc.)

{
  "mcpServers": {
    "tailwindcss-docs-mcp": {
      "command": "npx",
      "args": ["-y", "tailwindcss-docs-mcp"]
    }
  }
}

The embedding model downloads on first boot (~30 seconds), the docs index automatically, and every Tailwind question hits the local index from then on. No setup, no commands to run.

Using Tailwind v3? Set "env": { "TAILWIND_DOCS_MCP_DEFAULT_VERSION": "v3" } in your config.

Custom data directory? Set TAILWIND_DOCS_MCP_PATH (default: ~/.tailwindcss-docs-mcp).

What It Does

Your assistant gets four tools — search_docs, fetch_docs, list_utilities, and check_status — and calls them automatically when you ask Tailwind questions.

Search is hybrid: semantic vectors and full-text keywords run in parallel, merged with reciprocal rank fusion. Class names like text-lg or mx-auto are automatically expanded to their CSS properties. Both Tailwind v3 and v4 are indexed independently and switchable per query. Everything runs locally via snowflake-arctic-embed-xs and SQLite — nothing leaves your machine.

Development

git clone https://github.com/vitalis/tailwindcss-docs-mcp.git
cd tailwindcss-docs-mcp
bun install
bun run test            # vitest
bun run build           # tsc
bunx biome check src/   # lint

Getting Help

Acknowledgments

License