Testmo MCP Server

A Model Context Protocol (MCP) server that provides seamless integration with Testmo test management platform. Built with FastMCP, this server enables AI assistants to interact directly with your Testmo instance for test case management.

Features

📋 Test Case Management - Create, read, update, and delete test cases
📁 Folder Organization - Create and manage folders to organize test cases
🔍 Project Discovery - List projects, templates, and milestones
✅ Step-by-Step Tests - Create detailed test cases with steps and expected results
🏃 Test Run Support - List and manage test runs
🔧 Debug Tools - Built-in API debugging capabilities

Prerequisites

Python 3.10+
A Testmo account with API access
API token from your Testmo instance

Installation

1. Clone the Repository

git clone https://github.com/filipljoljic/Testmo-MCP.git
cd Testmo-MCP

2. Create Virtual Environment

python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install Dependencies

pip install -r requirements.txt

4. Configure Environment Variables

Set your Testmo credentials as environment variables:

export TESTMO_BASE_URL="https://your-instance.testmo.net"
export TESTMO_TOKEN="your_api_token_here"

Getting your API token:

Log into your Testmo instance
Go to Settings → API
Generate a new API token
Copy the token and use it in the environment variable

Usage

Running the MCP Server

python3 testmoMCP.py

The server will start and be ready to accept MCP connections from compatible AI assistants.

Integrating with Claude Desktop

Add the following to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "testmo": {
      "command": "python3",
      "args": ["/path/to/Testmo-MCP/testmoMCP.py"],
      "env": {
        "TESTMO_BASE_URL": "https://your-instance.testmo.net",
        "TESTMO_TOKEN": "your_api_token_here"
      }
    }
  }
}

Integrating with Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "testmo": {
      "command": "python3",
      "args": ["/path/to/Testmo-MCP/testmoMCP.py"],
      "env": {
        "TESTMO_BASE_URL": "https://your-instance.testmo.net",
        "TESTMO_TOKEN": "your_api_token_here"
      }
    }
  }
}

Available Tools

Project Management

Tool	Description
`list_projects`	List all projects to find project IDs
`get_project_templates`	Get available templates for a project
`get_project_folders`	List folders within a project
`get_milestones`	Get milestones for a project

Test Case Operations

Tool	Description
`create_test_case`	Create a new test case with steps
`create_test_case_with_steps_json`	Create test case with JSON-formatted steps
`create_test_case_raw`	Create test case with raw JSON payload
`get_test_case`	Get details of a specific test case
`list_test_cases`	List test cases in a project
`update_test_case`	Update an existing test case
`delete_test_cases`	Delete one or more test cases

Folder Management

Tool	Description
`create_folder`	Create a new folder for organizing test cases

Test Run Operations

Tool	Description
`list_test_runs`	List test runs in a project
`create_manual_test_run`	Create a manual test run (note: limited API support)

Debugging

Tool	Description
`debug_api_test`	Test API connectivity and view configuration

Examples

Creating a Test Case with Steps

Using natural language with an AI assistant:

"Create a test case called 'User Login Flow' with steps to navigate to login, enter credentials, and verify successful login"

The assistant will use the create_test_case tool with:

project_id: 1
title: "User Login Flow"
description: "Verify user can successfully log in to the application"
steps: "1. Navigate to login page | Expected: Login page loads
2. Enter valid credentials | Expected: Fields accept input
3. Click Login button | Expected: User is logged in and redirected to dashboard"

Listing Projects

"Show me all available Testmo projects"

The assistant will call list_projects and return:

Found Projects:
ID: 1 | Name: Web Application | Active: True
ID: 2 | Name: Mobile App | Active: True

Creating Organized Test Cases

"Create a folder called 'Authentication' in project 1, then create a test case inside it"

# First creates folder
create_folder(project_id=1, name="Authentication")
# Then creates test case in that folder
create_test_case(project_id=1, folder_id=<new_folder_id>, title="Login Test", ...)

API Reference

This MCP server integrates with the Testmo REST API v1. Key endpoints used:

GET /api/v1/projects - List projects
POST /api/v1/projects/{id}/cases - Create test cases
GET /api/v1/projects/{id}/cases - List test cases
PATCH /api/v1/projects/{id}/cases - Update test cases
DELETE /api/v1/projects/{id}/cases - Delete test cases
GET /api/v1/projects/{id}/folders - List folders
POST /api/v1/projects/{id}/folders - Create folders

Priority Values

When creating test cases, use these priority IDs:

ID	Priority
1	Low
2	Medium
3	High
4	Critical

Time Estimates

Estimates are specified in minutes:

Value	Duration
15	15 minutes
60	1 hour
480	8 hours (1 day)

Troubleshooting

API Connection Issues

Verify your TESTMO_BASE_URL is correct (should be like https://your-instance.testmo.net)
Check that your API token is valid and has appropriate permissions
Use the debug_api_test tool to diagnose connectivity issues

Test Case Creation Fails

Ensure you're using a valid project_id (use list_projects first)
For step-based test cases, get the correct template_id using get_project_templates
Verify folder exists if specifying folder_id

Steps Not Showing

Make sure to:

Use the "Case (steps)" template - get its ID via get_project_templates
Format steps correctly: "1. Step description | Expected: expected result"

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Testmo for providing a great test management platform
FastMCP for the MCP server framework
Anthropic for the Model Context Protocol specification