Menu

Mattering Automations Docker Hub integration

Connect Docker Hub to Mattering Automations: repositories, tags, immutable tag rules, teams, org membership, invites, and audit logs as workflow steps, authenticated with a Docker ID and personal access token.

The Mattering Automations Docker Hub integration adds Docker Hub's management surface to your automation canvas: create and update repositories, sync READMEs, list and delete tags, govern immutable tag rules, search public images, and administer an organization with members, teams, invites, settings, and audit log queries.

Setup takes a few minutes: create a personal access token in Docker Hub, attach it together with your Docker ID as a credential in Mattering, and test the connection. This guide walks through each step, explains how the connector authenticates, and ends with the full node reference.

Before you start

  • A Docker Hub account. A free Docker Personal account can create personal access tokens and covers the account, repository, tag, and search nodes.
  • A Mattering workspace with access to the Automations app.
  • For the organization nodes: an organization where your account holds the required role (most org administration requires an org owner). Per Docker's documentation, organization access tokens and audit logs require a Docker Team or Business subscription.

Create a Docker Hub personal access token

Mattering authenticates to Docker Hub with your Docker ID and a personal access token. Docker recommends tokens over your account password: they are scoped, revocable, and they keep working on accounts with two-factor authentication and in orgs that enforce single sign-on.

Sign in at hub.docker.com, click your avatar, and open Account settings.
Open Personal access tokens and click Generate new token.
Give the token a description (for example, Mattering Automations), choose an expiration date, and set the access permissions: Read, Write, or Delete. Pick the highest level your workflows actually need; only the delete nodes require Delete.
Free Docker Personal accounts can create personal access tokens. The permission level applies to the whole token, so many teams keep a Read token for reporting workflows and a separate Write or Delete token for workflows that change things.
Click Generate and copy the token.
Docker Hub shows the token exactly once. If you navigate away before copying it, deactivate that token and generate a new one. Note the expiry you chose: when the token expires, the connector's runs start failing with a 401 until you update the credential.

Connect Docker Hub to Mattering

In Mattering Automations, open Connectors and click Add Connector.
Choose Docker Hub from the list.
Click Create new credential. The username is your Docker ID (the Hub username, not your email address) and the password is the personal access token. Save.
Docker Hub's API does not accept a personal access token directly. On every run, Mattering exchanges your Docker ID and token for a short-lived session token at Docker's documented token endpoint (Docker's API reference documents it as expiring in 10 minutes) and uses that session token for the API calls. Your token is stored encrypted in Google Secret Manager, and neither it nor the session token appears in workflow logs.
Click Test Connection: Mattering performs the token exchange and calls Docker Hub's user endpoint, reporting which account it authenticated as.
Click Connect. All 38 Docker Hub nodes appear in your canvas palette.

Verify it works

After connecting, open any automation canvas and check the palette: a Docker Hub section should list 20 query nodes and 18 action nodes. Drop Docker Hub: Get Current User onto the canvas and run a test step; a successful response returns your Docker ID, full name, company, and join date.

Then try Docker Hub: List Repositories with your namespace (your Docker ID, or an org name). List nodes return a paginated envelope with count, next, previous, and results; when next is not null, feed it back as the next page rather than building URLs by hand.

Node reference

38 nodes, generated from the connector itself so this reference always matches what ships.

Read and query nodes 20

Docker Hub: Get Current User

dockerhub_get_current_user

Get the authenticated Docker Hub account: Docker ID, full name, company, and join date. Takes no parameters, so it doubles as the credential health check: a bad username or token fails before this call is even made. Stable route used by Docker's own hub-tool CLI as its whoami.

Docker Hub: Get Organization

dockerhub_get_org

Get one Docker Hub organization's profile: org name, full name, company, location, and join date. Stable route used by Docker's own hub-tool CLI.

Docker Hub: Get Organization Access Token

dockerhub_get_org_access_token

Get one organization access token's metadata by id, including the resources it can reach. The secret value is NOT returned.

Docker Hub: Get Organization Settings

dockerhub_get_org_settings

Get an organization's settings, currently the restricted images policy (whether members may only use org images, official images, and verified publisher images). Requires org owner permission.

Docker Hub: Get Personal Access Token

dockerhub_get_access_token

Get one personal access token's metadata by UUID: label, scopes, active state, and expiry. The secret token value is NOT returned.

Docker Hub: Get Repository

dockerhub_get_repository

Get one repository's full details: description, README (full_description), star and pull counts, privacy, media types, and immutable-tag settings.

Docker Hub: Get Repository Tag

dockerhub_get_tag

Get one tag's details: compressed size, last push and pull times, status, and its per-platform images with digests at data.images[].

Docker Hub: Get Team

dockerhub_get_group

Get one team (group) in an organization: id, name, description, and member count.

Docker Hub: List Audit Log Actions

dockerhub_list_audit_log_actions

List the audit log action names available for a namespace, grouped by area, for use as the action filter on Docker Hub: List Audit Log Events.

Docker Hub: List Audit Log Events

dockerhub_list_audit_log_events

Query audit log events for a namespace (org or user): who did what and when, at data.logs[]. Filter by action (for example repo.tag.push), object name, actor, and a time window. Requires permission on the account being queried.

Docker Hub: List My Organizations

dockerhub_list_my_orgs

List the Docker Hub organizations the authenticated account belongs to, with each org's name, company, and profile details. Stable route used by Docker's own hub-tool CLI.

Docker Hub: List Organization Access Tokens

dockerhub_list_org_access_tokens

List an organization's access tokens (OATs): label, creator, active state, and expiry. Requires org owner permission and an org on a paid subscription. Secret values are not returned. Read only by design.

Docker Hub: List Organization Invites

dockerhub_list_org_invites

List an organization's pending invites: invitee (Docker ID or email), inviter, target team, and creation time at data.data[]. Requires org owner permission.

Docker Hub: List Organization Members

dockerhub_list_org_members

List an organization's members with username, email, role (Owner, Member, or Invitee), team memberships, and guest status. Requires permission to view the org's members.

Docker Hub: List Personal Access Tokens

dockerhub_list_access_tokens

List the authenticated account's personal access tokens: label, scopes, active state, creation and last-used times, and expiry. The secret token values are NOT returned (the token field comes back empty). Read only by design: creating or revoking credentials stays in the Docker Hub UI.

Docker Hub: List Repositories

dockerhub_list_repositories

List the image repositories in a namespace (a user or organization) with name, description, star and pull counts, and privacy. Supports partial name filtering and ordering by name, last_updated, or pull_count.

Docker Hub: List Repository Tags

dockerhub_list_tags

List a repository's tags with size, push/pull timestamps, active/inactive status, and the per-platform image list (architecture, OS, digest) embedded in each tag at data.results[].images[].

Docker Hub: List Team Members

dockerhub_list_group_members

List the members of a team (group) with username, full name, and email. Search filters by username, full name, or email.

Docker Hub: List Teams

dockerhub_list_groups

List an organization's teams (groups) with name, description, and member count. Filter by a member's username or search by team name.

Docker Hub: Search Repositories

dockerhub_search_repositories

Search public Docker Hub repositories by keyword, returning repo name, short description, star and pull counts, and official-image flags. Same index the docker search command uses; verified live against hub.docker.com.

Action nodes 18

Docker Hub: Add Team Member

dockerhub_add_group_member

Add an existing organization member to a team (group). Reversible via Docker Hub: Remove Team Member. The user must already belong to the organization.

Docker Hub: Cancel Invite

dockerhub_cancel_invite

Cancel a pending organization invite by id. Reversible by sending a fresh invite to the same person.

Docker Hub: Create Repository

dockerhub_create_repository

Create a new image repository in a namespace, optionally with a short description, a README (full_description), and private visibility. Reversible via Docker Hub: Delete Repository. Free accounts have limited private repositories, so is_private may be rejected on a full plan.

Docker Hub: Create Team

dockerhub_create_group

Create a new team (group) in an organization. Reversible via Docker Hub: Delete Team. Requires org owner permission.

Docker Hub: Delete Repository

dockerhub_delete_repository

DESTRUCTIVE: permanently delete a repository including all of its tags, its pull and star history, and its description. There is no trash and no restore. Stable route used by Docker's own hub-tool CLI (repo rm). The PAT needs delete scope.

Docker Hub: Delete Repository Tag

dockerhub_delete_tag

DESTRUCTIVE: delete a tag from a repository. The tag reference is gone immediately; the underlying image manifest survives only while another tag still points at it. Fails if the repository has immutable tags enabled and the tag matches a protected rule. Stable route used by Docker's own hub-tool CLI (tag rm). The PAT needs delete scope.

Docker Hub: Delete Team

dockerhub_delete_group

DESTRUCTIVE: delete a team (group) from an organization. Its members stay in the org but the team's repository permissions are gone and must be rebuilt by hand. Requires org owner permission.

Docker Hub: Grant Team Repository Access

dockerhub_grant_repository_group_access

Grant a team (group) access to a repository at read, write, or admin level. Reversible by granting a lower level or removing the team's access in the Hub UI.

Docker Hub: Invite Members

dockerhub_bulk_invite_members

Invite one or more users to an organization by Docker ID or email, optionally into a specific team and role. Each invite consumes a seat when accepted. Reversible via Docker Hub: Cancel Invite. Set dry_run true to validate without sending anything.

Docker Hub: Remove Organization Member

dockerhub_remove_org_member

DESTRUCTIVE: remove a member from an organization. They lose access to the org's repositories and teams immediately; getting them back requires a fresh invite they must accept. Requires org owner permission.

Docker Hub: Remove Team Member

dockerhub_remove_group_member

Remove a user from a team (group). They stay in the organization; reversible via Docker Hub: Add Team Member.

Docker Hub: Resend Invite

dockerhub_resend_invite

Resend the email for a pending organization invite by id. Changes no membership state.

Docker Hub: Update Immutable Tag Settings

dockerhub_update_immutable_tags

Enable or disable immutable tags on a repository and set the regex rules for which tags are protected from being overwritten or deleted. Reversible by calling again with immutable_tags false or different rules.

Docker Hub: Update Organization Member Role

dockerhub_update_org_member_role

Change an organization member's role to owner, editor, or member. Requires org owner permission. Reversible by setting the previous role back.

Docker Hub: Update Organization Settings

dockerhub_update_org_settings

Update an organization's restricted images policy: whether members are limited to the org's own images, and whether Docker official images and verified publisher images stay allowed. Reversible by putting the previous values back. Requires org owner permission.

Docker Hub: Update Repository Description

dockerhub_update_repository

Update a repository's short description and/or its README-style full description (the classic push-README-from-CI call). Only the fields you fill are changed. Stable route without a documented replacement yet; it is the same call the widely-used dockerhub-description GitHub Action makes. The PAT needs write scope on the repository.

Docker Hub: Update Team

dockerhub_update_group

Rename a team (group) or change its description. Only the fields you fill are changed. Requires org owner permission.

Docker Hub: Verify Immutable Tag Rule

dockerhub_verify_immutable_tag_rule

Dry-run an immutable-tag regex against a repository's existing tags: returns the list of tags the rule would protect, without changing any settings. Use before Docker Hub: Update Immutable Tag Settings.

Using the integration

On the automation canvas

Docker Hub nodes chain with every other node: a weekly schedule can list repositories and tags and file a stale-tag review task, a docs change can push the README with the update description node, and audit log queries can write into a Mattering database for reporting.

From AI assistants over MCP

Every node speaks MCP, the open protocol for connecting AI assistants to tools. Claude, ChatGPT, and Matter can inspect repositories and tags, search public images, sync descriptions, and manage teams through the same nodes your workflows use.

Organization administration, carefully

The org nodes cover members, teams, invites, settings, and audit logs. Four nodes are flagged destructive because they are hard to undo: Docker Hub: Delete Repository, Docker Hub: Delete Repository Tag, Docker Hub: Remove Organization Member, and Docker Hub: Delete Team. Put an approval step in front of them, and use the invite node's dry run flag to validate a member list before sending anything.

Troubleshooting

Test Connection fails with a 401
Docker Hub rejected the credential at the token exchange. Check that the username is your Docker ID (the Hub username, not your email address) and that the token is active and not expired in Account settings > Personal access tokens. In orgs that enforce single sign-on, password authentication is unavailable and a personal access token is required.
The connection tests fine but a node returns 403
The token's permission level or your account's role is too low for that call. Delete nodes need a token with Delete permission; repository writes need Write; org administration nodes (members, teams, invites, settings) require an org owner. Generate a token at the right level or ask an org owner to run the workflow under their credential.
Organization access token or audit log nodes fail
These surfaces require an organization on a Docker Team or Business subscription, per Docker's documentation, and org owner permission. A free Docker Personal account still covers the account, repository, tag, and search nodes in full.
Runs start failing with 429 responses
Docker Hub enforces per-minute API rate limits, reported through X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset response headers with a Retry-After header on the 429. Docker does not publish the numeric quota. Space out scheduled runs and reduce page sizes on large listing loops; the limit resets within the minute.
Docker Hub: Delete Repository Tag fails on a specific tag
The repository likely has immutable tags enabled and the tag matches a protected rule. Run Docker Hub: Verify Immutable Tag Rule to see which tags a rule protects, and adjust the rules with Docker Hub: Update Immutable Tag Settings if the tag really should be deletable.
You need a workflow to react the moment an image is pushed
The Hub API has no documented webhook management surface (Docker documents webhooks as configured in the repository UI), so this integration has no push trigger. Schedule a query instead: Docker Hub: List Repository Tags shows recent pushes per tag, and Docker Hub: List Audit Log Events can filter for push actions on org repositories.

Docker Hub is a trademark of its respective owner. Mattering uses platform names to identify the services these integrations connect to; no endorsement or affiliation is implied.

Start Free Explore our Products