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:

1. Log into your Testmo instance
2. Go to Settings → API
3. Generate a new API token
4. 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

Test Case Operations

Folder Management

Test Run Operations

Debugging

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:

Time Estimates

Estimates are specified in minutes:

Troubleshooting

API Connection Issues

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

Test Case Creation Fails

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

Steps Not Showing

Make sure to:

1. Use the "Case (steps)" template - get its ID via get_project_templates
2. 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