Testmo

You run a Testmo MCP Server to enable AI assistants to manage Testmo test cases, folders, projects, and test runs directly through MCP connections. This server exposes a focused set of capabilities that streamline test management through conversational or automated interfaces, letting you create, read, update, and organize test artifacts with ease.

How to use

Start the MCP server and connect your MCP client to begin performing common Testmo actions. You will interact with the server through the client’s MCP channel, issuing tools to manage projects, test cases, folders, and test runs. Use natural language or structured tool calls to perform operations like creating a test case with steps, listing projects, or debugging API connectivity. Whenever you want to run an action, invoke the appropriate tool (for example, list_projects, create_test_case, or debug_api_test) and the server will respond with the results or next steps.

When you need to configure the client, point it to the local server using the standard runtime command and provide the required environment values for your Testmo instance. The client should be able to connect over the MCP protocol and send requests that map to Testmo REST endpoints.

How to install

Prerequisites: ensure you have Python 3.10 or newer and an active Testmo account with API access. You will also need a Testmo API token.

1. Create a Python virtual environment and activate it.

2. Install dependencies from the project requirements.

3. Prepare your environment variables with your Testmo credentials.

4. Run the MCP server.

5. Connect your MCP client to the running server.

# Create and activate a virtual environment
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Run the MCP server
python3 testmoMCP.py

Configuration and security

Configure your Testmo instance details and API token as environment variables to secure access to your Testmo data.

Environment variables used by the MCP server are visible to clients that connect to it. Provide these values in your runner or orchestration tool when launching the MCP server.

Example environment setup for a local run: set the base URL of your Testmo instance and your API token before starting the server.

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

python3 testmoMCP.py

Using with Claude Desktop or Cursor (client configuration)

Configure Claude Desktop or Cursor to load the local MCP server by pointing to the Python runtime and the path to the server script, and by passing required environment variables.

{
  "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"
      }
    }
  }
}

Notes on interaction

The MCP server exposes endpoints to manage projects, folders, and test cases, among other features. Use the tools exposed by the server to perform actions such as listing projects, creating test cases with steps, and debugging API connectivity.

Troubleshooting

If the MCP server cannot connect to Testmo, verify that TESTMO_BASE_URL is correct and that TESTMO_TOKEN has appropriate permissions.

If test case creation fails, ensure you pass valid project IDs and that folders exist when needed. Use debug_api_test to diagnose connectivity issues.

Examples

Creating a test case with steps, listing projects, and organizing test cases are common workflows you can perform through the MCP client by invoking the corresponding tools.

API Reference and available tools

The server integrates with Testmo REST API v1. Tools cover project discovery, test case operations, folder management, test run operations, and debugging.

License

This project is licensed under the MIT License.

Supported tools and actions

Project Management: list_projects, get_project_templates, get_project_folders, get_milestones.

Test Case Operations: create_test_case, create_test_case_with_steps_json, create_test_case_raw, get_test_case, list_test_cases, update_test_case, delete_test_cases.

Folder Management: create_folder.

Test Run Operations: list_test_runs, create_manual_test_run.

Debugging: debug_api_test.

Available tools

list_projects

List all projects to discover IDs and metadata

get_project_templates

Fetch available templates for a project

get_project_folders

List folders within a project

get_milestones

Retrieve milestones for a project

create_test_case

Create a new test case with optional steps and details

create_test_case_with_steps_json

Create a test case using a JSON-formatted steps payload

create_test_case_raw

Create a test case with a raw JSON payload

get_test_case

Retrieve details for a specific test case

list_test_cases

List test cases within a project

update_test_case

Update an existing test case

delete_test_cases

Delete one or more test cases

create_folder

Create a new folder within a project to organize test cases

list_test_runs

List test runs within a project

create_manual_test_run

Create a manual test run (where supported by the API)

debug_api_test

Test API connectivity and view current configuration