Targetprocess MCP Server

🎯 Targetprocess MCP Server

An MCP (Model Context Protocol) server implementation for Targetprocess project management platform, providing semantic AI-powered operations alongside traditional API access.

Turn your AI assistant into a Targetprocess power user - manage projects, track work, and update tasks through natural conversation.

Installation

Choose your preferred method:

🤖 Claude Desktop

Native integration with Anthropic's Claude Desktop app.

{
  "mcpServers": {
    "targetprocess": {
      "command": "npx",
      "args": ["-y", "https://github.com/aaronsb/apptio-target-process-mcp.git"],
      "env": {
        "TP_DOMAIN": "your-domain.tpondemand.com",
        "TP_API_KEY": "your-api-key"
      }
    }
  }
}

Full Claude Desktop guide →

📂 Claude Code

Use with Anthropic's Claude Code IDE (claude.ai/code)

# Add to project
claude mcp add targetprocess npm run targetprocess

# Configure .env
TP_DOMAIN=your-domain.tpondemand.com
TP_API_KEY=your-api-key

Full Claude Code guide →

🐳 Docker

Run in an isolated container environment.

# With API key (recommended)
docker run -i --rm \
  -e TP_DOMAIN=your-domain.tpondemand.com \
  -e TP_API_KEY=your-api-key \
  ghcr.io/aaronsb/apptio-target-process-mcp

# With role-specific tools and strict mode (recommended for MCP clients)
docker run -i --rm \
  -e TP_DOMAIN=your-domain.tpondemand.com \
  -e TP_USERNAME=your-username \
  -e TP_PASSWORD=your-password \
  -e TP_USER_ROLE=developer \
  -e TP_USER_ID=your-user-id \
  -e TP_USER_EMAIL=your-email \
  -e MCP_STRICT_MODE=true \
  ghcr.io/aaronsb/apptio-target-process-mcp

Full Docker configuration guide →

📦 NPX

Zero installation required. Perfect for trying out the server.

# With API key (recommended)
TP_DOMAIN=your-domain.tpondemand.com TP_API_KEY=your-api-key \
  npx -y https://github.com/aaronsb/apptio-target-process-mcp.git

# With role-specific tools and strict mode (recommended for MCP clients)
TP_DOMAIN=your-domain.tpondemand.com TP_USERNAME=your-username TP_PASSWORD=your-password \
TP_USER_ROLE=developer TP_USER_ID=your-user-id TP_USER_EMAIL=your-email \
MCP_STRICT_MODE=true \
  npx -y https://github.com/aaronsb/apptio-target-process-mcp.git

Full NPX configuration guide →

💻 Local Development

Clone and run locally for development.

# Clone and setup
git clone https://github.com/aaronsb/apptio-target-process-mcp.git
cd apptio-target-process-mcp
npm install

# Configure
cp .env.example .env
# Edit .env with your credentials

# With role-specific tools and strict mode
TP_USER_ROLE=developer \
  TP_USER_ID=your-user-id \
  TP_USER_EMAIL=your-email \
  MCP_STRICT_MODE=true

Full local development guide →

Configuration

API Authentication

Option 1: API Key (Recommended)

Go to Targetprocess → Settings → Access Tokens
Create a new token
Set TP_API_KEY environment variable

Option 2: Basic Auth

Set both:

TP_USERNAME: Your Targetprocess username
TP_PASSWORD: Your Targetprocess password

⚠️ Security Note: Never commit credentials to version control. Use environment variables or .env files (gitignored).

Available Tools

The server provides these MCP tools to AI assistants:

Tool	Description
search_entities	Search with powerful filtering, sorting, and includes
get_entity	Retrieve detailed entity information
create_entity	Create new work items with validation
update_entity	Update existing entities
inspect_object	Explore entity types and properties

Role-Specific Tools

All tools provide semantic hints and workflow suggestions. When you configure a user role, you get additional specialized tools:

Role	Additional Tools
`developer`	`show_my_tasks`, `start_working_on`, `complete_task`, `show_my_bugs`, `log_time`
`project-manager`	Project oversight and team management tools
`tester`	Test case and bug management tools
`product-owner`	Backlog and feature prioritization tools

# Enable role-specific tools
TP_USER_ROLE=developer        # Your role
TP_USER_ID=your-user-id       # For assignments
TP_USER_EMAIL=your-email      # For identification

Environment Variables Reference

Variable	Required	Description
`TP_DOMAIN`	Yes	Your Targetprocess domain (e.g., company.tpondemand.com)
`TP_API_KEY`	Yes*	API key for authentication (recommended)
`TP_USERNAME`	Yes*	Username for basic authentication
`TP_PASSWORD`	Yes*	Password for basic authentication
`TP_USER_ROLE`	No	Enable role-specific tools: `developer`, `project-manager`, `tester`, `product-owner`
`TP_USER_ID`	No	Your Targetprocess user ID (for assignments)
`TP_USER_EMAIL`	No	Your email (for identification)
`MCP_STRICT_MODE`	No	Set to `true` for MCP clients requiring clean JSON-RPC

*Either API key or username/password required

For detailed configuration examples, see the guides above.

IBM watsonx Orchestrate Integration

# Import as a toolkit in watsonx Orchestrate
orchestrate toolkits import \
  --kind mcp \
  --name targetprocess \
  --package-root /path/to/apptio-target-process-mcp \
  --command '["node", "build/index.js"]' \
  --tools "*"

Toolkit integration guide →

What can I do with it?

# Examples of what you can ask your AI assistant:

"Show me all open user stories in the mobile app project"
"Create a bug for the authentication failure on the login page"
"What's the status of our Q2 release?"
"Update the priority of story #12345 to high"
"Show me all tasks assigned to Sarah"
"Which team has the most open bugs right now?"

More use cases →

Documentation

Getting Started - First steps and basic usage
Core Concepts - Understanding the key components
Tools Reference - Detailed API documentation
Use Cases - Common workflows and examples
AI Integration - Setting up with Claude, ChatGPT, etc.
Architecture - System design and implementation
Development - Contributing and extending

Features

Role-Specific Tools (Developer Role)

When configured with TP_USER_ROLE=developer, these additional tools become available:

show_my_tasks: View assigned tasks with smart filtering and priority analysis
start_working_on: Begin work on tasks with automatic state transitions
complete_task: Mark tasks complete with integrated time logging and comments
show_my_bugs: Analyze assigned bugs with dynamic severity categorization
log_time: Record time with intelligent entity type discovery and validation
add_comment: Add contextual comments with workflow-aware follow-up suggestions

Note: All tools (both core and role-specific) provide semantic hints and workflow suggestions.

Core API Tools

Entity Management: Create, read, update, and search Targetprocess entities
Complex Queries: Filter items by custom fields, status, relationships, and more
Data Discovery: Explore entity types, properties, and relationships
Rich Includes: Retrieve related data in a single request

Enterprise Features

Role-Based Access: Tools filtered by personality configuration (developer, PM, tester)
Dynamic Discovery: Adapts to custom Targetprocess configurations automatically
Error Resilience: Transforms API failures into actionable guidance
Documentation Access: Built-in access to Targetprocess documentation
LLM Integration: Works with Claude, ChatGPT, and other AI assistants

License

MIT

Deploy Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Provides tools for interacting with Targetprocess, a project management and agile planning platform, enabling AI assistants to search, create, and update project entities with proper validation.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Linear MCP Server
ibraheem4
A
security
A
license
A
quality
Enables AI agents to manage issues, projects, and teams on the Linear platform programmatically.
Last updated -
83
MIT License
Project Handoffs MCP Server
davidorex
A
security
F
license
A
quality
Facilitates AI session handoffs and next steps tracking through project-based organization, supporting task prioritization and seamless workflow management.
Last updated -
8
7
Linear MCP Integration Server
MadeByNando
-
security
F
license
-
quality
Enables AI models to interact with Linear for issue tracking and project management through capabilities like creating/searching issues, managing sprints, and retrieving workflow states.
Last updated -
ClickUp MCP Server
DiversioTeam
A
security
A
license
A
quality
Enables AI assistants to interact with ClickUp's task management API for core project workflows, supporting operations like task creation, updates, search, assignment, and team analytics through natural language.
Last updated -
28
2
MIT License

View all related MCP servers

Targetprocess MCP Server