Docker Hub
Docker Hub is a service provided by Docker for finding and sharing container images with your team.
Verdict
Common use cases
- Provision repos for new microservices from chat
- Invite contractors to org during onboarding
- Wire webhooks to trigger CI builds
- Audit team permissions across namespaces
- Clean up stale repos after sprint
Integration
- Vendor
- Docker Hub
- Category
- developer-tools
- Auth
- API_KEY
- Tools
- 26
- Composio slug
docker_hub
Tools
- Add Organization Member
Tool to send an invitation for a user to join a Docker Hub organization. Use when you need to grant membership by inviting a user via their username after choosing the appropriate role.
- Create Docker Hub Organization
Tool to create a Docker Hub organization. Use when you need to programmatically instantiate a new namespace for organizing repositories.
- Create Docker Hub Repository
Tool to create a Docker Hub repository under a namespace. Use when you need to programmatically instantiate a new repo under your organization or user.
- Create Docker Hub Webhook
Tool to create a webhook on a Docker Hub repository. Use after determining repository details.
- Delete Docker Hub Organizationdestructive
Tool to delete a specific Docker Hub organization. Use when you need to permanently remove an organization. Deletion is irreversible.
- Delete Docker Hub Repositorydestructive
Tool to delete a specific Docker Hub repository. Use when you need to permanently remove a repository. Deletion is irreversible.
- Delete Docker Hub repository webhookdestructive
Tool to delete a specific webhook from a repository. Use when cleaning up outdated or misconfigured webhooks.
- Delete Docker Hub Teamdestructive
Tool to delete a specific team from an organization. Use after confirming the team exists in Docker Hub.
- Delete Repository Imagedestructive
Tool to delete a specific image within a Docker Hub repository. Use when you have confirmed the namespace, repository, and image ID to remove.
- Delete Repository Tagdestructive
Tool to delete a specific tag from a Docker Hub repository. Use after confirming the tag to remove.
- Get Docker Hub Image
Tool to retrieve detailed information about a specific image within a Docker Hub repository. Use after confirming namespace, repository name, and image ID. Example: GET_IMAGE(namespace="library", repository="ubuntu", image_id="sha256:...")
- Get Docker Hub Repository
Tool to retrieve details of a specific Docker Hub repository. Use after confirming namespace and repository name.
- Get Docker Hub Tag
Tool to retrieve details of a specific Docker Hub repository tag. Use after confirming the namespace, repository, and tag name.
- Get Docker Hub Team
Tool to retrieve a specific Docker Hub team. Use after confirming the organization and team exist.
- Get Docker Hub Webhook
Tool to retrieve details of a specific Docker Hub webhook. Use when you need to inspect an existing webhook's configuration by its ID.
- Get Organization Details
Tool to retrieve details of a specific organization namespace. Use when you have the organization slug and need its namespace metadata.
- List Docker Hub Organization Members
Tool to list members of a Docker Hub organization. Use when managing or auditing organization membership.
- List Docker Hub Organizations
Tool to list organizations (namespaces) for the authenticated user. Use after authentication to retrieve namespaces.
- List Docker Hub Repositories
Tool to list repositories under a namespace. Use when you need to enumerate repositories within a specific Docker Hub namespace, with optional filtering and pagination.
- List Docker Hub repository webhooks
Tool to list webhooks for a Docker Hub repository. Use when you need to retrieve all existing webhooks after confirming repository details.
- List Organization Teams
Tool to list teams in a specific organization. Use after confirming the organization slug.
- List Repository Images
Tool to list image variants for a specific Docker Hub repository. Use after specifying namespace and repository.
- List Repository Tags
Tool to list tags for a Docker Hub repository. Use after specifying namespace and repository.
- List Team Members
Tool to list members of a Docker Hub team. Use when you need to retrieve all users in a specific team.
- Remove Organization Memberdestructive
Tool to remove a user from a Docker Hub organization. Use when you need to revoke a user's existing membership after confirming the organization and username.
- Remove Team Memberdestructive
Tool to remove a user from a Docker Hub team. Use when you need to revoke membership from a team after verifying the user is currently a member.
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Find Docker Hub in the MCP catalog and click Connect. 3. You'll be prompted to paste a Docker Hub Personal Access Token — generate one at hub.docker.com under Account Settings > Security. 4. Grant the token write permissions for repositories, organizations, and webhooks (read-only tokens will fail on create/delete operations). 5. Paste the token into Switchy and click Authorize. 6. To test the connection, open any Space and type '@Docker Hub list my repositories' — you should see your repos appear in seconds. 7. From there, @mention Docker Hub anytime you need to create a repo, invite a teammate, or configure a webhook without switching tabs.
What teammates see: by default, memories from Docker Hub are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Create Service Repo
@Docker Hub create a new repository called 'payment-service' under our organization namespace, set it to private, and add a short description about handling payment processing.Open in a Space →
Invite New Developer
@Docker Hub invite the user 'alex_dev' to our organization with the 'member' role so they can push to our repos.Open in a Space →
Set Up Deploy Webhook
@Docker Hub create a webhook on the 'api-gateway' repository that posts to https://ci.example.com/hooks/docker-push whenever a new image is pushed.Open in a Space →
Audit Org Members
@Docker Hub show me all members of our organization along with their roles and when they joined.Open in a Space →
Clean Up Old Repos
@Docker Hub delete the repository 'legacy-monolith' from our organization — we've fully migrated off it.Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@dockerhub list all repositories in our 'acme-corp' organization and show which ones haven't been updated in the last 90 days
I found 12 repositories in the acme-corp organization. Three haven't been updated recently: 'legacy-api' (last push 147 days ago, 2.3k pulls), 'old-worker' (last push 203 days ago, 890 pulls), and 'deprecated-frontend' (last push 312 days ago, 156 pulls). The remaining 9 repos have activity within the past month, with 'main-service' being the most active (updated 2 days ago, 45k pulls).
This read-heavy example demonstrates repository discovery and filtering. Requires API key with read access to the organization. Response times depend on repository count; organizations with hundreds of repos may see slower queries. The MCP doesn't automatically archive stale images—you'll need to decide on cleanup actions separately.
@dockerhub create a new repository called 'ml-inference-service' in our organization with a description and set it to private visibility
I've created the repository 'acme-corp/ml-inference-service' with private visibility. Description set to 'Machine learning inference API service'. The repository is now ready to receive image pushes. No webhooks or teams are configured yet—you can set those up separately. The repository URL is hub.docker.com/r/acme-corp/ml-inference-service.
This write example shows repository provisioning. Requires API key with write permissions on the organization namespace. Creating a repository doesn't automatically configure CI/CD pipelines or access controls—you'll need to set team permissions and webhooks in follow-up steps. Private repos count against your organization's plan limits.
@dockerhub review all webhooks across our repositories and identify any pointing to deprecated staging URLs, then draft a migration plan
I scanned 12 repositories and found 8 active webhooks. Three are pointing to deprecated endpoints: 'legacy-api' has a webhook to staging-old.acme.com (returns 404), 'main-service' has two webhooks where one targets ci-deprecated.acme.com, and 'worker-queue' points to jenkins-v1.acme.com (no longer in DNS). Recommended migration: update these to your current CI endpoint (ci.acme.com), test with a manual trigger, then delete the old hooks. I can execute these updates if you confirm the new endpoint.
This synthesis example pairs webhook enumeration with AI reasoning to identify configuration drift. The MCP can read webhook configs and delete outdated ones, but cannot test endpoint reachability—you'll need to verify new URLs externally. Webhook updates require deleting and recreating (no in-place edit), which briefly interrupts delivery during the swap.
Use-case deep-dives
When this MCP wins for spinning up contractor access fast
A 6-person dev team brings on two contractors for a 3-month feature push. The lead needs to grant them read access to 4 private repos and write access to 1 staging repo, then revoke it all when the contract ends. The Docker Hub MCP handles this in a single Switchy thread: create the contractor accounts as org members with the right role, assign them to a temporary team scoped to those repos, then delete the team and memberships when the sprint wraps. The API key auth means the lead doesn't juggle OAuth tokens or share their personal credentials. This breaks down if you're onboarding more than 10 people at once—at that scale, you want a proper IDP integration, not a chat interface. For small-batch contractor workflows, though, the MCP turns a 20-minute ClickOps chore into a 90-second conversation.
When this MCP saves time after a CI pipeline migration
A 4-person platform team just migrated from Jenkins to GitHub Actions. They have 18 Docker Hub repos, each with 2-4 webhooks pointing at the old Jenkins endpoints. The webhooks are firing 404s on every push, cluttering logs and confusing the on-call rotation. The Docker Hub MCP lets the team list all webhooks across their org repos in one query, identify the stale Jenkins URLs, and delete them in bulk without opening 18 browser tabs. The 26-tool scope includes webhook CRUD, so the entire cleanup happens in a single Switchy session. This scenario assumes you're working with under 50 repos—beyond that, you'd script it directly against the API rather than chat through it. For mid-sized cleanup jobs after a tooling shift, the MCP turns a tedious audit into a 5-minute thread.
When this MCP handles white-label registry setup for new customers
A 10-person SaaS startup provisions a dedicated Docker Hub org and 3 repos for each new enterprise customer as part of their white-label onboarding flow. The support team used to file Jira tickets for DevOps to run Terraform; now they use the Docker Hub MCP in Switchy to create the org, repos, and initial webhooks in real time while the customer waits on a Zoom call. The create-org and create-repo tools cover the happy path, and the delete tools let support clean up if a trial customer churns before converting. This works cleanly for 2-5 new customers per week; if you're onboarding 20+ customers daily, you want this logic in your backend provisioning service, not a shared AI workspace. For low-to-mid-volume customer onboarding, the MCP collapses a 48-hour ticket cycle into a 3-minute live demo.
Frequently asked
What does the Docker Hub MCP let me do in Switchy?
It connects your Docker Hub account so your team can create repositories, manage webhooks, invite organization members, and delete resources — all through natural language in Switchy. You can automate tasks like spinning up a new repo under your org namespace or cleaning up outdated webhooks without opening the Docker Hub UI. The MCP exposes 26 tools covering org, repo, team, and webhook management.
Do I need admin access to connect Docker Hub?
You need a Docker Hub API key with permissions matching the actions you want Switchy to perform. For org-level tasks like creating repos or inviting members, the key must belong to an account with admin or owner rights in that organization. If you only manage personal repos, a standard user key works. Generate the key in Docker Hub's account settings under Security.
Can the MCP pull or push Docker images?
No. This MCP handles Docker Hub metadata — creating repos, managing webhooks, inviting users, deleting teams. It doesn't interact with the Docker daemon or registry protocol, so you can't push images or pull layers through Switchy. For image operations, use the Docker CLI or your CI/CD pipeline. The MCP is for administrative tasks, not container workflows.
Why use this instead of the Docker Hub web UI?
The MCP lets you script repetitive admin tasks in plain English and chain them with other tools in Switchy. If you're onboarding five engineers, you can say "invite these users to the Docker org and create a repo for each" in one prompt. The UI requires clicking through forms for each action. The trade-off: the MCP can't show you image tags or scan results — use the UI for browsing.
Who on the team should connect the Docker Hub MCP?
Whoever owns your Docker Hub organization or has admin rights to the repos you want Switchy to manage. Since the API key inherits that account's permissions, connecting with a junior developer's key will fail on org-level tasks. If multiple people need access, connect one admin key in Switchy and share the workspace — don't create separate connections per person.