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.
Connect Docker Hub to Mattering
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
The connection tests fine but a node returns 403
Organization access token or audit log nodes fail
Runs start failing with 429 responses
Docker Hub: Delete Repository Tag fails on a specific tag
You need a workflow to react the moment an image is pushed
Related
The Docker Hub MCP
What connecting Docker Hub unlocks for AI agents and automations, with common uses and FAQs.
More guides
All Automations documentation
Every integration guide, plus how connectors, credentials, and workflows fit together.
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.