Hugging Face MCP Server
Hugging Face Official MCP Server
Hugging Face's official MCP server: Hub search and Gradio apps from Spaces as agent tools
- 310 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Calls third-party apps from Spaces
- Uses a Hugging Face token and can launch Jobs
Install
- Works in
Manual install
claude mcp add hf-mcp-server -t http https://huggingface.co/mcp?loginThen start claude and complete authentication.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Calls third-party apps from Spaces
- Uses a Hugging Face token and can launch Jobs
This is third-party code. Review the repository files before installing.
What it does
The server connects an agent to the Hugging Face Hub: search and details for model, dataset and Space repositories, plus Hub file access. Beyond built-in tools the agent can call Gradio apps from Spaces that the user picks at huggingface.co/settings/mcp. With authentication, Jobs, dynamic Spaces and a sandbox are also available. Hugging Face hosts the server, and it also runs locally via npx or Docker.
Who it is for. For ML engineers and developers who look for models and datasets or want to call AI apps from Spaces.
Good fit when
- You need a model or dataset for a task without leaving the agent
- You want to call a Gradio app, such as image generation, as a tool
- You need to look at a Hub repository's files and card
Not a fit when
- You have no Hugging Face account but need Jobs or private repos
- You need local model inference without the cloud
Example request
Find a small, openly licensed Russian speech recognition model on Hugging FaceMCP
- Transport
- http, stdio
- Authentication
- OAuth
Environment variables
HF_TOKENsecret- Hugging Face token for local STDIO mode
DEFAULT_HF_TOKENsecret- Default token for local STDIO, takes precedence over HF_TOKEN
TRANSPORT- stdio or streamableHttpJson
DISABLE_TOOLS- Tools to hide and reject
Limitations
Some tools need an OAuth login or a Hugging Face token. Spaces run on Hugging Face and may sleep or fail, and heavy apps consume account quotas. Access to Hugging Face from Russia without a VPN is unreliable.
How to disable. Run claude mcp remove hf-mcp-server or remove the Hugging Face connector in your client settings, then revoke the token on huggingface.co.
FAQ
How do I choose which Spaces the agent sees?
In your account settings at huggingface.co/settings/mcp. The tool set is resolved per request.
Can I drop images from Gradio responses?
Yes, add ?no_image_content=true to the server URL.
Discussion
No questions or reviews yet.
Related
MCP serversA Python framework and CLI for MCP: write servers as plain functions, test tools and install servers into Claude Code, Cursor and other clients
An MCP server that inserts a human feedback step into agent tasks: a web or desktop window for text, images and prompts
A read-only MCP server for the HeyClaude registry: an agent finds skills, MCP servers and hooks and gets ready install commands
A universal MCP CLI client from Apify: persistent sessions, OAuth, JSON output for scripts and shell access to any MCP server for agents
ChatMCP
chatmcp
A cross-platform chat client with MCP for macOS, Windows, Linux, iOS, Android and the web. The latest release came out in August 2025
A CLI for any MCP server: list and call tools, resources and prompts, run mock and proxy modes, guard access and manage agent configs
README in short
The README starts with installing the hosted server in Claude Desktop, Claude Code, Gemini CLI, VS Code and Cursor with OAuth or a token. It then covers repository packages, STDIO and Streamable HTTP transports, and local runs via npx and Docker. Most of it deals with environment variables, CSV proxy tools, skill distribution and Space monitoring for self-hosters.