@aqx-qa/testmo-mcp

A TypeScript MCP server for Testmo test management. Provides 40+ tools for AI assistants to manage test cases, runs, automation, and more.

Setup

Install

npm install @aqx-qa/testmo-mcp

Configure MCP Client

Add to your MCP config (Claude Desktop, Kiro, etc.):

{
  "mcpServers": {
    "testmo": {
      "command": "npx",
      "args": ["-y", "@aqx-qa/testmo-mcp"],
      "env": {
        "TESTMO_URL": "https://your-instance.testmo.net",
        "TESTMO_API_KEY": "your-api-key"
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | | ----------------- | -------- | ----------------------------------------------------- | | TESTMO_URL | Yes | Your Testmo instance URL | | TESTMO_API_KEY | Yes | API key from Testmo settings | | TESTMO_EMAIL | No | Testmo login email (enables test assignment tools) | | TESTMO_PASSWORD | No | Testmo login password (enables test assignment tools) |

Note: TESTMO_EMAIL and TESTMO_PASSWORD are optional. They enable the assign_run_test and bulk_assign_run_tests tools which use Testmo's internal web UI routes (the public API does not support test assignment). Credentials are only sent over HTTPS and held in memory — never logged or written to disk.

Available Tools

| Category | Tools | | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Projects | list_projects, get_project | | Folders | list_folders, create_folders, update_folders, delete_folders | | Cases | list_cases, get_case, get_all_cases, create_cases, update_cases, delete_cases | | Runs | list_runs, get_run, create_run, update_run, delete_run | | Results | list_run_results, assign_run_test, bulk_assign_run_tests | | Attachments | list_case_attachments, upload_case_attachment, delete_case_attachments | | Automation | list_automation_sources, get_automation_source, list_automation_runs, get_automation_run, create_automation_run, append_automation_run, complete_automation_run, create_automation_run_thread, append_automation_run_thread, complete_automation_run_thread | | Milestones | list_milestones, get_milestone | | Users | list_users, get_user, list_project_users | | Config | list_fields, list_states, list_statuses, list_tags, list_templates, list_configs, list_issue_connections |

All tools are prefixed with testmo_ (e.g. testmo_list_cases).

* Requires TESTMO_EMAIL + TESTMO_PASSWORD env vars.

Development

npm install
npm run build
npm test

License

ISC