Hugging Face’s official remote MCP server (
huggingface/hf-mcp-server), hosted by Hugging Face.
Why it matters
Finding the right model or dataset for a task meant searching the Hugging Face Hub separately. Connect the Hugging Face MCP and you can search models, datasets, Spaces, papers, and docs in natural language — and call Gradio Space-backed tools — from Claude Code.
What you can do
Representative tasks from Hugging Face’s official docs:
- Search models — “Search Hugging Face models for Qwen 3 Quantizations.”
- Search datasets — “Show datasets about weather time-series.”
- Find Spaces — “Find a Space that can transcribe audio files.”
- Generate images — “Create a 1024 x 1024 image of a cat ghibli style.” (Gradio Space tool)
- Search docs — “How do I use LoRA adapters with PEFT?”
- Search papers — “Find papers about vision-language models.”
Grounded in huggingface.co/docs/hub/en/hf-mcp-server and huggingface.co/blog/claude-and-mcp.
Key features
- Search — semantic search over models, datasets, Spaces, papers, and docs
- Hub details — detailed info on Models, Datasets, Spaces (optional README)
- Jobs — run, monitor, and schedule jobs on HF infrastructure
- Gradio Space tools — add MCP-compatible Spaces (image generation, audio transcription, etc.) as callable tools
Setup
Browser login:
claude mcp add hf-mcp-server -t http https://huggingface.co/mcp?login
Token header:
claude mcp add hf-mcp-server -t http https://huggingface.co/mcp -H "Authorization: Bearer YOUR_HF_TOKEN"
Toggle which tools are enabled at huggingface.co/settings/mcp.
Notes
- Auth — pass an HF access token (huggingface.co/settings/tokens) via the
?loginflow or an Authorization header - License — MIT (
huggingface/hf-mcp-server) - To use Gradio Space tools like image generation, add it in Claude as a custom connector (remote MCP URL
https://huggingface.co/mcp?login) - A local stdio mode is also supported