Hugging Face

Explore authentication, permissions and available actionsExact inputs, sign-in scopes, access limits and approval rules.

• Status: Ready to connect. Connect it and it works.
• Connects through: Hugging Face's own MCP server, https://huggingface.co/mcp, with a token from Hugging Face.
• Category: Data & analytics

What hires can doCopy Anchor Link

Models, datasets and Spaces on the Hugging Face Hub.

Hugging Face's MCP server decides which tools there are. When you test the connection, Roster asks it and lists every tool with whether it only reads or changes something. You choose which ones hires may use, and the list you save is the list they get, until you test again.

Make the keyCopy Anchor Link

1. Click Open Hugging Face's key page on the form, or open it here: huggingface.co.
2. Choose the Read role (Write if hires should push), name it Roster, create it and copy it.
3. Give it: Read.
4. Paste it on the form. It looks like hf_…; Roster tells you as you type if it doesn't. When you connect, Roster checks it with Hugging Face and shows whose account it is.

Connect itCopy Anchor Link

1. Open Integrations → Tools → Add a tool, search for Hugging Face and choose it.
2. Server address: filled in as https://huggingface.co/mcp. Leave it.
3. Paste a token into API token. In Hugging Face: Settings → Access Tokens → Create new token (read). Then click Connect.
4. Click Test connection. Untick any tool no hire should use, and click Save tools.

More in MCP servers.

Choose what each hire may doCopy Anchor Link

Connecting Hugging Face gives it to no one. On a hire's Tools tab, click Give access on the connection:

• Read only: only the tools the server marks as read-only, or that you ticked as Changes nothing.
• Read and write: every tool you saved on the connection.
• Tools: if you like, only some of them for this hire.

See Adding a tool.

When it asks firstCopy Anchor Link

On the connection, Ask before using starts at Tools that change things: every call to a tool that changes something waits for a person's approval in chat, and Roster makes exactly that call, once, when it's approved. Tools that only read never ask. Once you trust your hires with Hugging Face, you can change it to Only tools a hire is set to ask about.

To change it for one hire, or for single tools, use When it asks first on the hire's Tools tab (more).

Personal dataCopy Anchor Link

Hugging Face holds personal data about your visitors and what they did. Hires see what Hugging Face's tools return, shortened when it's very long, with the connection's own token or password taken out. Roster doesn't take anything else out. Give access only to hires whose work needs it, choose Read only where that's enough, and untick tools that return more than the work needs. Everything a hire does here is on its timecard.

Good to knowCopy Anchor Link

• Hires use Hugging Face while they work on something; changes in Hugging Face don't wake them. To have a hire check it regularly, give it a responsibility on a schedule.
• Which tools hires get is up to Hugging Face's server. When it adds or changes tools, click Test again on the connection; until then hires keep the tools you saved.
• If the sign-in expires or is revoked, hires are told plainly; click Reconnect on the connection.

Learn moreCopy Anchor Link

• Hugging Face's own docs
• huggingface.co
• Where Hugging Face gives its MCP server's address
• MCP servers
• Approvals
• Every tool

Tools and permissions reference

This reference is built from the same definitions Roster uses to connect Hugging Face and give hires access. It updates with each release.

Authentication and requested permissions

The account or app you connect sets the outer limit. Each hire's access can narrow it further. Connecting a tool gives it to no hire until you give access on that hire's Tools tab.

API key or access token

In Hugging Face: Settings → Access Tokens → Create new token (read).

When making a key, use these permissions from the connection guide:

• Read

Connection fields

Hugging Face connection fields

Field	What to provide
API token token Required · sealed secret	In Hugging Face: Settings → Access Tokens → Create new token (read).
Ask before using askFirst Optional	With “Tools that change things”, a hire's call to any tool here that changes something waits for a person's approval in chat, and runs exactly as asked once approved. New connections start there; choose the other option once you trust the hires with this connection. Each hire's Tools tab can also ask for single tools. Choices: Only tools a hire is set to ask about (never); Tools that change things (writes). Starts with: writes.

Per-hire limits

Read-only hires receive only actions that read. Read-and-write access also allows actions that change things, where the connection itself permits them. An empty resource allowlist usually means everything the connected account can reach; each field below explains its meaning.

Hugging Face per-hire limits

Field	What to provide
Tools tools Optional	Leave empty for every tool on this connection.

Actions

Actions come from the MCP server you connect, so there is no fixed action list to promise here.

Use Test connection to inspect the exact names, descriptions and read/write classifications; select the actions and Save tools. Retest when the service changes. A server's read-only labels are supplied by that server: review them before granting access.

Watches and incoming events

• No built-in watch is declared. Give a hire a scheduled responsibility if it should check this service regularly.
• No incoming webhook handler is declared for this integration.

Limits and troubleshooting

• Permission errors: check both the connected account's rights and the hire's resource and read/write limits.
• Expired or revoked access: reconnect or replace the key on the connection.
• Rate limits and unavailable services can interrupt work. The hire's timecard records the outcome.
• The action schema describes accepted inputs. It does not grant additional access or bypass approvals.

Service documentation · Integration source reference