Testrail MCP Server

by uarlouskiio.github.uarlouski/testrail-mcp-serverv3.2.0

Model Context Protocol (MCP) server for TestRail: let Claude, Cursor, and Windsurf manage test cases, runs, results, and attachments.

40Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active1d ago

Install Testrail MCP server

claude mcp add testrail -e TESTRAIL_INSTANCE_URL='<testrail-instance-url>' -e TESTRAIL_USERNAME='<testrail-username>' -e TESTRAIL_API_KEY='<testrail-api-key>' -- npx -y @uarlouski/testrail-mcp-server

{
  "mcpServers": {
    "testrail": {
      "command": "npx",
      "args": [
        "-y",
        "@uarlouski/testrail-mcp-server"
      ],
      "env": {
        "TESTRAIL_INSTANCE_URL": "<testrail-instance-url>",
        "TESTRAIL_USERNAME": "<testrail-username>",
        "TESTRAIL_API_KEY": "<testrail-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "testrail": {
      "command": "npx",
      "args": [
        "-y",
        "@uarlouski/testrail-mcp-server"
      ],
      "env": {
        "TESTRAIL_INSTANCE_URL": "<testrail-instance-url>",
        "TESTRAIL_USERNAME": "<testrail-username>",
        "TESTRAIL_API_KEY": "<testrail-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "testrail": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@uarlouski/testrail-mcp-server"
      ],
      "env": {
        "TESTRAIL_INSTANCE_URL": "<testrail-instance-url>",
        "TESTRAIL_USERNAME": "<testrail-username>",
        "TESTRAIL_API_KEY": "<testrail-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "testrail": {
      "command": "npx",
      "args": [
        "-y",
        "@uarlouski/testrail-mcp-server"
      ],
      "env": {
        "TESTRAIL_INSTANCE_URL": "<testrail-instance-url>",
        "TESTRAIL_USERNAME": "<testrail-username>",
        "TESTRAIL_API_KEY": "<testrail-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
TESTRAIL_INSTANCE_URL	yes	—	Base URL of your TestRail instance (e.g. https://example.testrail.io)
TESTRAIL_USERNAME	yes	—	Email address used to authenticate with TestRail
TESTRAIL_API_KEY	yes	yes	API key for authenticating with the TestRail API
TESTRAIL_ENABLE_SHARED_STEPS	—	—	Enable shared steps management
TESTRAIL_ENABLE_CASE_HISTORY	—	—	Enable test case history management
TESTRAIL_ENABLE_RAG_TOOLS	—	—	Enable Knowledge Base and RAG export tools
TESTRAIL_ALLOW_WRITE_OPERATIONS	—	—	Allow write operations on TestRail (defaults to true)
TESTRAIL_ALLOW_READ_OPERATIONS	—	—	Allow read operations on TestRail (defaults to true)
TESTRAIL_ALLOW_DELETE_OPERATIONS	—	—	Allow delete operations on TestRail (defaults to false)
TESTRAIL_ENABLE_DEPRECATED_TOOLS	—	—	Enable deprecated tools for backward compatibility (defaults to true)
TESTRAIL_DISABLED_TOOLS	—	—	Comma-separated list of tool names to disable
TESTRAIL_REQUEST_TIMEOUT_MS	—	—	Timeout in milliseconds for TestRail HTTP requests (defaults to 30000ms)

Freshness

Active — last maintenance signal 1d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-08 · 1d ago · GitHub
Latest release
2026-10-05 · 4d ago · GitHub · v3.2.0
Package published
no data · npm/PyPI
Registry entry updated
2026-10-05 · 4d ago · official registry · v3.2.0

FAQ

›How do I install the Testrail MCP server in Claude Code?

Run: claude mcp add testrail -e TESTRAIL_INSTANCE_URL='<testrail-instance-url>' -e TESTRAIL_USERNAME='<testrail-username>' -e TESTRAIL_API_KEY='<testrail-api-key>' -- npx -y @uarlouski/testrail-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Testrail require an API key?

Yes. It expects TESTRAIL_INSTANCE_URL, TESTRAIL_USERNAME, TESTRAIL_API_KEY, of which 1 is a secret.

›Can I use Testrail as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Testrail in the official MCP registry?

Yes, as io.github.uarlouski/testrail-mcp-server.