Targetprocess MCP Server

An MCP (Model Context Protocol) server that enables AI assistants to interact with the Targetprocess project management platform through structured tools and natural language workflows.

This server exposes powerful capabilities for querying, creating, and managing Targetprocess entities such as user stories, bugs, tasks, and features.

It acts as a bridge between LLM agents and the Targetprocess API, providing:

• Structured tool-based access
• Semantic, natural-language-driven workflows

Features

• Create Bugs based on user story

• Retreive TP entities: bugs, user stories

• LLM-Friendly Tools

  • Designed for Claude MCP AI agents

Use Cases examples:

• "Show me currently active release"
• "write me test cases based on 145322 tp user story"
• "add a comment to 145155 card saying 'test'"
• "write test cases based on 145640 user story"
• "write detailed test cases based on 145642 user story, format them inside html element and add them as a comment"
• "create a bug based on 145637 user story where Add Tile flyout (for a Static Tile) not show"
• "search for a card with 'Text Element' title"

Available tools:

Releases

• get_current_releases — List all current releases (no params needed)
• get_release_bugs — Get bugs for a release (name, optional results)
• get_release_features — Get features for a release (name, optional results)
• get_release_user_stories — Get user stories for a release (name, optional results)
• get_release_user_stories_with_description — Same as above but includes full descriptions (name, withDescription)
• get_release_open_bugs — Get only active/open bugs for a release (name, withDescription, optional results)
• get_release_open_user_stories — Get only active/open user stories for a release (name, withDescription, optional results)

Cards — Read

• get_bug_content — Fetch full content of a bug by ID (id)
• get_user_story_content — Fetch full content of a user story by ID (id)
• get_bug_comments — Get comments on a bug (id, optional results)
• get_user_story_comments — Get comments on a user story (id, optional results)
• search_all_cards_by_keyword — Search bugs, stories, and features by keyword (keyword)

Cards — Write

• add_comment — Post a comment to any card (id, comment)
• create_bug — Create a new bug linked to a card (card object with id+type, title, bugContent)
• create_test_plan — Create a test plan linked to a user story (title, userStoryId)

Installation

Local Installation for Development

{
  "mcpServers": {
    "targetprocess": {
      "command": "/Users/xxx/.config/nvm/versions/node/v22.14.0/bin/node",
      "args": [
        "/path/to/repository"
      ],
      "env": {
        "TP_TOKEN": "<your-tp-token>" // Settings -> Authentication and Security -> New Access Token,
        "TP_BASE_URL": "<tp-api-endpoint>",
        "TP_API_VERSION": "v1",
        "TP_OWNER_ID": "<tp-owner-id>", // your user id
        "TP_PROJECT_ID": "<tp-project-id>",
        "TP_TEAM_ID": "<tp-team-id>"
      }
    }
}

Claude Desktop

[!NOTE] You need to have node and npm installed on your machine.

{
  "mcpServers": {
    "targetprocess": {
      "command": "npx",
      "args": [
        "-y",
        "targetprocess-mcp-server"
      ],
      "env": {
        "TP_TOKEN": "<your-tp-token>" // Settings -> Authentication and Security -> New Access Token,
        "TP_BASE_URL": "<tp-api-endpoint>",
        "TP_API_VERSION": "v1",
        "TP_OWNER_ID": "<tp-owner-id>", // your user id
        "TP_PROJECT_ID": "<tp-project-id>",
        "TP_TEAM_ID": "<tp-team-id>"
      }
    }
  },
}

Claude Code

claude mcp add tarteprocess -s user \
  -e TP_TOKEN=<your-tp-token> -e TP_BASE_URL=<tp-api-endpoint> -- npx -y targetprocess-mcp-server

Local Development

git clone --recursive https://github.com/SerhiiMaksymiv/targetprocess-mcp-server.git
cd targetprocess-mcp-server

npm install
npm run build