Choosing the Right IDs in MCP: Find Projects, Boards, and Tasks
Navigate MCP IDs safely and accurately. This developer-friendly guide shows you how to find the right project, board, and task IDs, avoid acting on wrong items, and use prompt patterns that restate targets before performing operations.
What This Guide Covers
This guide helps you work with MCP IDs correctly:
Key Topics
- ID discovery: How to find project, board, and task IDs
- Verification patterns: Confirm you have the right ID before acting
- Safety prompts: Restate target before performing operations
- Common mistakes: How to avoid wrong ID errors
- Best practices: ID selection workflows
Finding IDs
Finding Project IDs
List Projects to Find ID
What the AI does:
- Calls
list_projectsto get all projects - Returns project list with IDs and names
- You can identify the project you need
Finding Task IDs
Search Tasks to Find ID
What the AI does:
- Calls
list_taskswith search filters - Returns matching tasks with IDs
- You can select the correct task ID
Finding Board IDs
List Boards to Find ID
What the AI does:
- Calls
list_boardsfor the project - Returns board list with IDs and names
- You can identify the board you need
Verification Patterns
Pattern 1: Get Before Update
Always fetch the item first to verify you have the right ID:
Safe Update Pattern
What the AI does:
- Calls
get_taskto fetch task details - Shows task information for verification
- Waits for confirmation
- Only then calls
update_task
Pattern 2: Restate Target Before Acting
Have the AI restate what it's about to act on:
Restatement Pattern
Benefits:
- AI explicitly states what it will act on
- You can verify before proceeding
- Prevents wrong ID mistakes
Pattern 3: Search Then Select
Search for items, then select from results:
Search and Select Pattern
Workflow:
- AI searches and shows results
- You select the correct task
- AI uses the selected ID
- Reduces ID confusion
Complete Examples
Example 1: Safe Task Update
Complete Safe Update Prompt
This pattern: Get → Verify → Restate → Confirm → Act
Example 2: Finding and Using Project ID
Complete Project ID Workflow
This pattern: Search → Verify → Use
Avoiding Common Mistakes
Common ID Mistakes
- Using wrong ID: Always verify ID matches the item you want
- Assuming ID format: Don't guess IDs—always fetch them
- Not verifying before write: Always get item details before updating
- ID confusion: Similar task titles can have different IDs
- Stale IDs: IDs don't change, but items might be deleted
Best Practices
ID Selection Best Practices
- Always list first: Use list operations to find IDs
- Get before update: Fetch item details before modifying
- Restate target: Have AI explicitly state what it will act on
- Search then select: Search for items, then choose from results
- Verify with names: Match IDs to names/titles before using
- Confirm before write: Always confirm ID is correct before write operations
Troubleshooting
Wrong Item Updated
Symptom: Updated the wrong task/project
Fix:
- Always use "get before update" pattern
- Have AI restate target before acting
- Verify ID matches item name/title
ID Not Found
Symptom: Error saying ID doesn't exist
Fix:
- List items to find current IDs
- Item may have been deleted
- Check you're using correct workspace
Related Resources
List Tasks Tool
Find task IDs
List Projects Tool
Find project IDs
Write Approval Patterns
Safe write operations
Cross-Project Search
Find items across projects
Navigate IDs Safely
Use verification patterns to ensure you're acting on the right items
