Testmo MCP Server

A Python Model Context Protocol (MCP) server for Testmo - bring AI-assisted test management to Claude Desktop, Cursor, and any MCP-compatible client.

Testmo MCP is an open-source MCP server that connects AI assistants like Claude Desktop, Claude Code, and Cursor directly to your Testmo test management instance. Manage test cases, folders, milestones, runs, attachments, and CI/CD automation sources — all through natural language, without leaving your AI client.

Built for QA engineers, SDETs, and developers who use Testmo and want to stop clicking through the UI for repetitive work. Powered by FastMCP and the Testmo REST API.

✨ Features

• 🧪 Full test case management — create, read, update, delete, search, and bulk-operate on Testmo cases

• 📁 Folder operations — create, rename, move, delete, and traverse folder trees recursively

• 🚀 Bulk & batch operations — create or update up to 100 cases per call, or unlimited with auto-batching

• 🏃 Test runs & results — list runs, fetch run details, and filter run results

• 🎯 Milestones — list and inspect milestones across projects

• 📎 Attachments — upload, list, and delete file attachments on test cases

• 🤖 CI/CD automation sources — manage automation runs, parallel threads, and result submission

• 🔗 Issue integrations — list GitHub, Jira, and other issue connections

• 🌳 Recursive helpers — fetch entire folder subtrees of cases in one call

• 🛠️ Field mapping utilities — resolve priority, type, and state IDs without guessing

• 🤝 Works with any MCP client — Claude Desktop, Claude Code, Cursor, Cline, and more

🚀 Quick start

Prerequisites

• Python 3.11 or newer

• uv package manager

• A Testmo instance and API key (Settings → API Keys in Testmo)

• An MCP-compatible client (Claude Desktop, Cursor, etc.)

Installation

git clone https://github.com/strelec00/testmo-mcp.git
cd testmo-mcp
uv sync

Configuration

Create a .env file in the project root:

TESTMO_URL=https://your-instance.testmo.net
TESTMO_API_KEY=your-api-key

Connect to Claude Desktop

Add this to your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "testmo": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/testmo-mcp", "run", "testmo-mcp.py"],
      "env": {
        "TESTMO_URL": "https://your-instance.testmo.net",
        "TESTMO_API_KEY": "your-api-key"
      }
    }
  }
}

Restart Claude Desktop. The Testmo tools will appear in the MCP tools list.

💡 You can pass credentials via either .env or the env block above — both work.

Connect to Cursor

Open Cursor Settings → MCP (or edit ~/.cursor/mcp.json) and use the same JSON snippet.

Dev / testing mode

uv run mcp dev testmo-mcp.py

💬 Example prompts

Once connected, try asking your AI assistant:

• "List all projects in Testmo and show me the one called Certilligent."

• "Create 20 login test cases covering valid credentials, wrong password, locked account, expired session, and 2FA flows."

• "Find the 'Smoke Tests' folder and list every high-priority case inside it recursively."

• "Bulk update all draft cases in folder 42 to set their priority to high."

• "Show me the latest automation run for the Playwright source and append a new thread of results."

• "Upload this screenshot as an attachment to test case 1234."

🧠 Why use Testmo with MCP?

Traditional Testmo workflows require navigating the UI for every test case, every folder, every bulk update. With Testmo MCP, your AI assistant becomes a QA co-pilot:

• Spin up entire test suites from a feature spec or PRD in seconds

• Refactor folder structures conversationally instead of click-by-click

• Keep Testmo in sync with your codebase without context-switching

• Pair with Claude Code for end-to-end QA automation: generate Playwright tests and register them in Testmo

• Wire CI/CD automation runs straight from your terminal session

🔧 Available tools

Projects

Folders

Test cases

Milestones

Test runs

Attachments

Automation (CI/CD)

Issue connections

Recursive / composite

Utility

🛠️ Troubleshooting

"Tool not found" in Claude Desktop Use an absolute path in args and fully restart Claude Desktop after editing the config.

401 Unauthorized Double-check TESTMO_API_KEY and that the key has API access enabled in Testmo under Settings → API Keys.

uv: command not found Install uv: curl -LsSf https://astral.sh/uv/install.sh | sh

🤝 Contributing

PRs welcome. Open an issue first for larger changes.

📄 License

MIT

🔗 Related projects

• Testmo — unified test management for software teams

• Model Context Protocol — open standard for AI tool integrations

• FastMCP — Pythonic framework for building MCP servers

• Claude Desktop — Anthropic's desktop client with MCP support

Keywords: testmo mcp, testmo claude, testmo ai integration, mcp server testmo, model context protocol testmo, testmo python, testmo api client, fastmcp testmo, ai test management, qa automation claude, testmo cursor, testmo automation api, testmo bulk create cases, anthropic mcp servers