Submit Log in

Hugging Face

by Hugging Face

v0.4.6

MIT

Repository Docs

Featured Developer Tools Web & Search

huggingfacemodelsdatasetsgradioresearchofficial

Summary

Official Hugging Face MCP server: search models, datasets, Spaces and papers on the Hub, read repository files, and call Gradio apps as agent tools.

Features

Semantic search across Hub models, datasets and Spaces
Search and read machine-learning papers indexed on the Hub
Browse and read files inside any Hub repository
Call public Gradio Spaces as MCP tools
Hosted Streamable HTTP endpoint with OAuth or HF_TOKEN auth
Self-hostable via Docker in stdio or HTTP mode
Per-user tool selection to keep the exposed tool list small

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

Open your agent's MCP configuration file.
Merge the snippet below into it.
Restart the agent — the "Hugging Face" tools will be available.

{
  "mcpServers": {
    "huggingface-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://huggingface.co/mcp?login"
      ]
    }
  }
}

Claude Code

Add the server with a single CLI command.

claude mcp add huggingface-mcp-server -- npx -y mcp-remote https://huggingface.co/mcp?login

Claude Desktop

Add the server to claude_desktop_config.json (Settings → Developer → Edit Config).

{
  "mcpServers": {
    "huggingface-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://huggingface.co/mcp?login"
      ]
    }
  }
}

Cursor

{
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote",
    "https://huggingface.co/mcp?login"
  ]
}

VS Code

{
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote",
    "https://huggingface.co/mcp?login"
  ]
}

Claude Code — hosted endpoint with browser login

{
  "command": "claude",
  "args": [
    "mcp",
    "add",
    "hf-mcp-server",
    "-t",
    "http",
    "https://huggingface.co/mcp?login"
  ]
}

Self-hosted Docker image in stdio mode

{
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-e",
    "TRANSPORT=stdio",
    "-e",
    "DEFAULT_HF_TOKEN",
    "hf-mcp-server"
  ],
  "env": {
    "DEFAULT_HF_TOKEN": "hf_xxx"
  }
}

Description

The Hugging Face MCP Server is the vendor-maintained bridge between an MCP client and the Hugging Face Hub. Instead of pasting model cards into a prompt, an agent can query the Hub directly — searching models, datasets, Spaces and research papers, then pulling the exact files it needs out of a repository through the built-in filesystem tool.

The second half of the server is what makes it unusual: Hugging Face Spaces built with Gradio expose themselves as MCP tools, so any of the thousands of public Gradio applications on the Hub — image generation, transcription, OCR, background removal — become callable functions for your agent without you writing an integration for each one.

The hosted endpoint at https://huggingface.co/mcp is the fastest route: Claude Code, Claude Desktop, VS Code, Cursor and Gemini CLI all connect over Streamable HTTP, with OAuth login or a personal HF_TOKEN bearer header. The same TypeScript server can be self-hosted from source or the published Docker image, in either stdio or stateless HTTP mode, which is the practical choice when you need to restrict the toolset (DISABLE_TOOLS) or point the server at an internal deployment.

Useful details: the server is MIT-licensed and published as hf-mcp; token-free anonymous access works for public read operations, while anything touching your own repos or private Spaces needs a token; and per-user tool selection ("bouquets") keeps the tool list small enough not to crowd out the rest of your agent's tools.

Related MCP Servers

MCP: Azure DevOps MCP Server

by Microsoft

New

Microsoft's official MCP server for Azure DevOps - work items, repos, pipelines, wikis, test plans and iterations, reachable from any MCP client in plain language.

Developer Tools

MCP: Serena

by Oraios AI

New

Semantic code toolkit for coding agents — symbol-level search, editing and refactoring backed by language servers or the JetBrains platform.

Developer Tools

MCP: GitLab MCP Server

by GitLab

New

GitLab's own MCP server — issues, merge requests, CI/CD pipelines, job logs, wikis and semantic code search over an OAuth-authorised HTTP endpoint.

Developer Tools

MCP: Mobile MCP

by Mobile Next

New

Platform-agnostic MCP server that drives iOS and Android apps on simulators, emulators and real devices through the accessibility tree rather than screenshots.

Developer Tools

Browse all MCP servers →