
AWS HealthOmics MCP Server: Setup for Claude, Cursor and Other Apps
Lets your assistant create and run genomics workflows in AWS HealthOmics, then diagnose failed runs and find sequence files.
This is the AWS Labs server for AWS HealthOmics. It runs on your computer and uses your AWS profile to manage workflows, runs, run groups, sequence and reference stores, and container setup.
It has no read-only mode. It can start runs that cost money and delete batches and configurations, so use an AWS profile limited to what you want it to touch.
Good for
- Bioinformatics teams that run WDL, CWL or Nextflow pipelines on HealthOmics
- Researchers who want help finding why a run failed
- Platform engineers who set up run groups, caches and container registries
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install aws-healthomics-mcp-server
Claude Code
- 1
Copy this prompt.
Add the aws-healthomics-mcp-server server to Claude Code. Run this command: claude mcp add aws-healthomics -- uvx awslabs.aws-healthomics-mcp-server Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires uv (Python).
Built from the package data we hold. Not yet tested by us.
Tools
Lists your HealthOmics workflows
Lists the HealthOmics workflows in your account, with paging.
Try: “List my HealthOmics workflows.”
Read ·
ListAHOWorkflowsShows one workflow and its definition
Returns details of a workflow and can export its definition.
Try: “Show the definition of my variant-calling workflow.”
Read ·
GetAHOWorkflowCreates a workflow from WDL, CWL or Nextflow
Creates a workflow from a ZIP file, an S3 location or inline content.
Try: “Create a Nextflow workflow from the ZIP in s3://my-bucket/rnaseq.zip.”
Write ·
CreateAHOWorkflowChecks a WDL or CWL file for errors
Runs lint checks on a single WDL or CWL workflow file using miniwdl and cwltool.
Try: “Lint this WDL file before I upload it.”
Runs code ·
LintAHOWorkflowDefinitionStarts a workflow run
Starts a run with the parameters, resources and tags you set. Runs use compute that is billed to your account.
Try: “Start the variant-calling workflow on sample NA12878.”
Write ·
StartAHORunLists workflow runs
Lists runs, filtered by status and date.
Try: “Show failed runs from the last three days.”
Read ·
ListAHORunsShows details of one run
Returns the status and metadata of a run.
Try: “What is the status of run 1234567?”
Read ·
GetAHORunExplains why a run failed
Looks over a failed run and suggests fixes.
Try: “Why did run 1234567 fail?”
Read ·
DiagnoseAHORunFailureShows logs for a run
Returns high-level logs and events from a workflow run.
Try: “Show the logs for run 1234567.”
Read ·
GetAHORunLogsAnalyzes run speed and resource use
Studies run data to find slow tasks and tasks that used too little or too much CPU and memory.
Try: “Which tasks in run 1234567 were the bottleneck?”
Read ·
AnalyzeAHORunPerformanceFinds genomics files across stores
Searches S3 buckets, HealthOmics sequence stores and reference stores for files such as FASTQ, BAM and VCF.
Try: “Find the FASTQ files for NA12878.”
Read ·
SearchGenomicsFilesBundles workflow files into a ZIP
Packages workflow files into a base64-encoded ZIP for upload. It can also write the ZIP to a local file or an S3 location you give it.
Try: “Package the files in ./pipeline for HealthOmics.”
Write ·
PackageAHOWorkflowImports genomic files into a sequence store
Starts a job that copies genomic files from S3 into a sequence store.
Try: “Import the FASTQ files in this S3 folder into my sequence store.”
Write ·
StartAHOReadSetImportJobStarts many runs of one workflow
Starts a batch of runs of one workflow with an IAM role and an S3 output location. The runs use compute billed to your account.
Try: “Start a batch run of workflow 1234567 for these ten samples.”
Write ·
StartAHORunBatchCancels a batch of runs
Cancels a batch of workflow runs.
Try: “Cancel batch abc123.”
Write ·
CancelAHORunBatchDeletes all runs in a batch
Deletes every run that belongs to a batch. This is the one that removes the runs, not just the batch record.
Try: “Delete all the runs in batch 7654321.”
Delete ·
DeleteAHORunBatchDeletes a run batch
Deletes the metadata of a run batch. The runs in the batch are not deleted.
Try: “Delete batch abc123.”
Delete ·
DeleteAHOBatchDeletes a HealthOmics configuration
Deletes a configuration used for workflow runs.
Try: “Delete the old test configuration.”
Delete ·
DeleteAHOConfiguration
Read from the source code
Permissions
high risk · 4 things to watch
High risk
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It can start runs that cost money
Starting runs and run batches uses HealthOmics compute billed to your account. Ask it to confirm the workflow and sample before it starts.
It can delete runs, batches and configurations
DeleteAHORunBatch deletes every run in a batch. DeleteAHOBatch and DeleteAHOConfiguration remove records. Use an AWS profile without delete permissions if you do not need them.
It can change container registry access
Container tools can clone images into ECR and grant HealthOmics access to repositories. Review these changes in your account.
The workflow linter runs on your computer
The lint tools run miniwdl and cwltool locally on the files you point at.
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | No read-only mode is documented. Limit what it can do with the IAM permissions of the AWS profile you give it. |
|---|---|
| Talks to | AWS HealthOmics, S3, ECR and CloudWatch APIs in your AWS account and region |
| Sign-in and keys | Uses your AWS profile or access keys from your computer. |
Questions
Can it run read-only?
No. The README documents no read-only switch. Use an AWS profile whose IAM permissions only allow read actions if you want that.
Can it delete things?
Yes. It can delete all the runs in a batch, delete batch records and delete configurations, and it can cancel batches of runs.
Is this the full tool list?
No. The server registers more than 70 tools and this page lists the main ones.
Does it need an AWS account?
Yes. It uses your AWS profile or access keys, and your IAM user needs HealthOmics permissions. Set the AWS region too.
Does it run on my computer or in the cloud?
It runs on your computer and calls AWS from there.
Which apps can use it?
Any app that runs local servers, such as Claude Code, Claude Desktop, Cursor and VS Code. The install box shows the setup for each.
Information
updated Nov 2, 2026
- Publisher
- Amazon Web Services (official)
- Package
awslabs.aws-healthomics-mcp-server- Registry
- PyPI
- Transport
- stdio
- License
- Apache-2.0
- Last commit
- Oct 30, 2026
- Open issues
- 143
- Listed in
- Docker MCP Catalog
Other AWS MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 1Hide
- aws-healthomics MCP server README · github.com