MCP server · AI and machine learning
Hugging Face MCP server
Lets an assistant search Hugging Face models, datasets, Spaces and papers, run Jobs and call Gradio apps as tools.
- Maintainer
- Hugging Face (official)
- Licence
- MIT
- Runs
- Remote (URL)
- Sign-in
- OAuth sign-in in the app
- Registry version
- 0.2.33 (updated 2025-10-22)
- Last activity
- 2026-10-13
Overview
What it does
Hugging Face hosts its official MCP server at huggingface.co/mcp. Adding ?login to the URL starts an OAuth sign-in; you can instead send a Hugging Face token in an Authorization header. Once connected, the assistant can search and explore the Hub and call MCP-compatible Gradio apps hosted on Spaces. You choose extra tools and Spaces on your MCP settings page at huggingface.co/settings/mcp. The source is open, and the README also documents running it locally with npx or Docker.
Use it when you research models or datasets, look up library documentation, or want to call a hosted AI app, such as image generation or transcription, from your assistant. A built-in hf_fs tool handles most Hub navigation, including semantic search of docs and Spaces. Optional tools create repositories and write files to them, run and schedule Jobs on Hugging Face infrastructure, and manage sandboxes. A Dynamic Spaces option lets the assistant find and use MCP Spaces on the fly.
Tools
What the assistant can do
- Search models, datasets, Spaces and papers on the Hub
- Semantic search of Hugging Face documentation
- Navigate the Hub with the hf_fs tool
- Call MCP-compatible Gradio Spaces as tools
- Run, monitor and schedule Jobs
- Create and use sandboxes
- Create repositories and write files to them
Install
Install Hugging Face MCP server in your app
You need:
- A Hugging Face account for sign-in and for repository, Job, dynamic Space and sandbox tools
- An MCP client with remote server support
Run in your project. --scope local keeps the servers private to you in this project; use user for every project.
claude mcp add --scope local --transport http hugging-face 'https://huggingface.co/mcp?login'
- hugging-face: if the server needs a sign-in, the app will ask (run /mcp in Claude Code).
Project root. Commit it to share the servers with your team; each person sets the variables in their own shell.
{
"mcpServers": {
"hugging-face": {
"type": "http",
"url": "https://huggingface.co/mcp?login"
}
}
}
- hugging-face: if the server needs a sign-in, the app will ask (run /mcp in Claude Code).
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json (Settings → Developer → Edit Config). Restart Claude after saving.
{
"mcpServers": {}
}
- hugging-face is a remote server: add it as a custom connector (Customize → Connectors → + Add → Add custom connector; on Team and Enterprise plans an owner adds it under Organization settings → Connectors), with the URL https://huggingface.co/mcp?login.
In your project, or ~/.cursor/mcp.json for every project.
{
"mcpServers": {
"hugging-face": {
"url": "https://huggingface.co/mcp?login"
}
}
}
- hugging-face: if the server needs a sign-in, the app will ask.
In your workspace. VS Code asks for each secret the first time a server starts and stores it securely.
{
"servers": {
"hugging-face": {
"type": "http",
"url": "https://huggingface.co/mcp?login"
}
}
}
- hugging-face: if the server needs a sign-in, the app will ask.
macOS/Linux: ~/.config/devin/mcp_config.json · Windows: %APPDATA%\devin\mcp_config.json. Read by the default Devin Local agent and by the legacy Cascade agent.
{
"mcpServers": {
"hugging-face": {
"url": "https://huggingface.co/mcp?login"
}
}
}
- hugging-face: if the server needs a sign-in, the app will ask.
Want it alongside other servers? Open Hugging Face MCP Server in the MCP config generator and add the rest; it writes one file per app. The snippets follow the setup in the server’s README, checked on 2026-10-14.
Before you install
- Repository, Job, dynamic Space and sandbox tools act with your Hugging Face account, so they can create repos, write files and start jobs.
- Community Spaces are third-party apps. Arguments the assistant sends to a Space tool go to that Space, so add only Spaces you trust.
- If you use a token header instead of OAuth, give the token only the access the tools you enable need.
- A remote server sees whatever the assistant sends it. Sign in with the narrowest access the service offers. See how to choose a safe server.
Why it’s listed
Why we list it
The official gateway to the largest open model hub, with hosted setup and access to thousands of Gradio apps as tools.
Related
More MCP servers
- Filesystem MCP ServerLets an assistant read, write, edit, move and search files, but only inside the folders you allow.
- Git MCP ServerLets an assistant check status, read diffs and logs, stage, commit and switch branches in a local Git repository.
- Fetch MCP ServerLets an assistant fetch a web page and read it as Markdown, in chunks, with private addresses blocked by default.
All MCP serversMCP config generatorGuide: MCP servers in Claude CodeGuide: what is MCP?