Skip to main content
Watch: I Built an AI App Without Leaving Databricks

AI and ML platforms - official Hugging Face server

Hugging Face MCP server

Hosted MCP server that connects assistants to the Hugging Face Hub to search and explore models, datasets, Spaces, papers and documentation, run Jobs and sandboxes, and call MCP-compatible Gradio Spaces as tools. Hugging Face hosts it at https://huggingface.co/mcp, or you can run @llmindset/hf-mcp-server (npm) locally with OAuth or API key auth.

Last verified 4 tools4 sources

Install

Terminal
claude mcp add hf-mcp-server -t http https://huggingface.co/mcp?login
JSON
"huggingface": {
    "url": "https://huggingface.co/mcp",
    "headers": {
        "Authorization": "Bearer <YOUR_HF_TOKEN>"
    }

VS Code

JSON
"huggingface": {
    "url": "https://huggingface.co/mcp",
    "headers": {
        "Authorization": "Bearer <YOUR_HF_TOKEN>"
    }

Tools

hf_fs
Built-in tool to navigate the Hub, including semantic searches of Documents and Spaces.
Contribute Repos
Create and write files to those created repositories (optional tool group, enabled in MCP settings).
Sandboxes
Create and use Sandboxes, including Sandbox file management (optional tool group).
Run and Manage Jobs
Run, monitor, and schedule jobs on Hugging Face infrastructure (optional tool group).

As documented on October 17, 2026. A running server reports its current list through tools/list.

Notes and caveats

  • Use https://huggingface.co/mcp?login for the OAuth login flow, or https://huggingface.co/mcp with an Authorization: Bearer HF token header.
  • Tools and Spaces are configured per user at huggingface.co/settings/mcp, which also generates client-specific config snippets.
  • Repository creation, Jobs, dynamic Space and sandbox tools require authentication.
  • The Cursor and VS Code snippets are copied verbatim from the README and are fragments (missing a closing brace) meant to sit inside the client's server map.
  • Add ?no_image_content=true to strip ImageContent blocks from Gradio Spaces.
  • Docs list Codex among supported clients but give no Codex snippet.

FAQ

What does the Hugging Face MCP server do?

Hosted MCP server that connects assistants to the Hugging Face Hub to search and explore models, datasets, Spaces, papers and documentation, run Jobs and sandboxes, and call MCP-compatible Gradio Spaces as tools. The vendor documents 4 tools, including hf_fs, Contribute Repos, Sandboxes and Run and Manage Jobs.

How do I add the Hugging Face MCP server to Claude Code?

Run claude mcp add hf-mcp-server -t http https://huggingface.co/mcp?login, copied from Hugging Face's docs. This page also has snippets for Cursor and VS Code.

Does the Hugging Face MCP server need authentication?

Yes, OAuth or API key. Transport: Streamable HTTP, stdio. Status: Unlabelled, last checked October 17, 2026.

Sources

Last verified against 4 Hugging Face pages, then re-checked independently.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.