PlugWiki
aws-healthomics-mcp-server logo

AWS HealthOmics MCP Server: Setup for Claude, Cursor and Other Apps

Official · by Amazon Web ServicesLocal
GetPyPIawslabs.aws-healthomics-mcp-serverawslabs/mcp/tree/HEAD/src/aws-healthomics-mcp-server

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.

Install aws-healthomics-mcp-server

Claude Code

  1. 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. 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 · ListAHOWorkflows

  • Shows 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 · GetAHOWorkflow

  • Creates 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 · CreateAHOWorkflow

  • Checks 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 · LintAHOWorkflowDefinition

  • Starts 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 · StartAHORun

  • Lists workflow runs

    Lists runs, filtered by status and date.

    Try: “Show failed runs from the last three days.”

    Read · ListAHORuns

  • Shows details of one run

    Returns the status and metadata of a run.

    Try: “What is the status of run 1234567?”

    Read · GetAHORun

  • Explains why a run failed

    Looks over a failed run and suggests fixes.

    Try: “Why did run 1234567 fail?”

    Read · DiagnoseAHORunFailure

  • Shows logs for a run

    Returns high-level logs and events from a workflow run.

    Try: “Show the logs for run 1234567.”

    Read · GetAHORunLogs

  • Analyzes 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 · AnalyzeAHORunPerformance

  • Finds 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 · SearchGenomicsFiles

  • Bundles 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 · PackageAHOWorkflow

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-onlyNo read-only mode is documented. Limit what it can do with the IAM permissions of the AWS profile you give it.
Talks toAWS HealthOmics, S3, ECR and CloudWatch APIs in your AWS account and region
Sign-in and keysUses 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

GitHubDockerDocker 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 1
  1. aws-healthomics MCP server README · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.