---
title: Hugging Face
description: Access the Hugging Face Hub and thousands of Gradio apps.
type: connection
keywords:
  - mcp
  - models
  - datasets
  - spaces
  - gradio
  - ai
  - oauth
  - connect
---

# Hugging Face

Connection integration for eve. Access the Hugging Face Hub and thousands of Gradio apps.

## Install

Add the connection from eve's registry. This writes the initial definition under `agent/connections/` and installs its authentication dependency when needed:

```bash
eve add connection/hugging-face
```

## Quick start

### MCP · User

Create `agent/connections/hugging-face.ts`. The connection name is derived from the filename:

```ts
// agent/connections/hugging-face.ts
import { connect } from "@vercel/connect/eve";
import { defineMcpClientConnection } from "eve/connections";

export default defineMcpClientConnection({
  url: "https://huggingface.co/mcp?login&gradio=none",
  description: "Hugging Face: models, datasets, Spaces, and Gradio apps on the Hub.",
  auth: connect("hugging-face"),
});
```

Connect owns the OAuth flow, and each end-user authorizes in their own browser before their first tool call.

## Configure

### MCP · User

Link your project, create the connector, and pull OIDC locally:

```bash
vercel link
vercel connect create hugging-face
vercel env pull
```

See the [Connections docs](/docs/connections) for principal types, headers, approval, and protocol-specific filters.

[Read the full connection documentation](/docs/connections/mcp)

---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)