testrail-mcp-server

testrail-mcp-server is a local MCP server: Connect AI assistants to TestRail: manage test cases, suites, runs, results, and attachments. Install it from npm as @uarlouski/testrail-mcp-server.

Claude CodeCodexAntigravity

commandprompt

Terminal

claude mcp add testrail-mcp-server -e TESTRAIL_INSTANCE_URL=... -e TESTRAIL_USERNAME=... -e TESTRAIL_API_KEY=... -e TESTRAIL_ENABLE_SHARED_STEPS=... -e TESTRAIL_ENABLE_CASE_HISTORY=... -e TESTRAIL_ENABLE_RAG_TOOLS=... -e TESTRAIL_ALLOW_WRITE_OPERATIONS=... -e TESTRAIL_ALLOW_READ_OPERATIONS=... -e TESTRAIL_ALLOW_DELETE_OPERATIONS=... -e TESTRAIL_ENABLE_DEPRECATED_TOOLS=... -e TESTRAIL_DISABLED_TOOLS=... -- npx -y @uarlouski/testrail-mcp-server

Run in your project folder. Add --scope user to use it everywhere.

Add to claude_desktop_config.json or .cursor/mcp.json.

{
  "mcpServers": {
    "testrail-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@uarlouski/testrail-mcp-server"
      ],
      "env": {
        "TESTRAIL_INSTANCE_URL": "...",
        "TESTRAIL_USERNAME": "...",
        "TESTRAIL_API_KEY": "...",
        "TESTRAIL_ENABLE_SHARED_STEPS": "...",
        "TESTRAIL_ENABLE_CASE_HISTORY": "...",
        "TESTRAIL_ENABLE_RAG_TOOLS": "...",
        "TESTRAIL_ALLOW_WRITE_OPERATIONS": "...",
        "TESTRAIL_ALLOW_READ_OPERATIONS": "...",
        "TESTRAIL_ALLOW_DELETE_OPERATIONS": "...",
        "TESTRAIL_ENABLE_DEPRECATED_TOOLS": "...",
        "TESTRAIL_DISABLED_TOOLS": "..."
      }
    }
  }
}

Fill in the environment variables with your own credentials.

• Runtime: Node.js 18+ (runs with npx).
• MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
• Environment variables: TESTRAIL_INSTANCE_URL, TESTRAIL_USERNAME, TESTRAIL_API_KEY, TESTRAIL_ENABLE_SHARED_STEPS, TESTRAIL_ENABLE_CASE_HISTORY, TESTRAIL_ENABLE_RAG_TOOLS, TESTRAIL_ALLOW_WRITE_OPERATIONS, TESTRAIL_ALLOW_READ_OPERATIONS, TESTRAIL_ALLOW_DELETE_OPERATIONS, TESTRAIL_ENABLE_DEPRECATED_TOOLS, TESTRAIL_DISABLED_TOOLS