Corcava MCP Tools: Complete Reference

Complete index of all Corcava MCP tools. Each tool is a function your AI assistant can call to interact with your Corcava workspace. Browse by category or use the quick reference table.

Tools by Category

Task Management

• list_tasks - Search and filter tasks by project, board, status, due date, or keyword
• get_task - Get full details of a specific task including description, comments, and metadata
• create_task - Create a new task with title, description, dates, and assignments
• update_task - Update task details, change status, move between columns, or modify fields
• delete_task - Remove a task permanently (irreversible operation)

Project Management

• list_projects - List all projects you have access to with basic metadata
• get_project - Get project details including members, settings, and related boards

Board Workflows

• list_boards - List workflow boards, optionally filtered by project
• get_board - Get board details including columns, states, and task counts

Task Comments

• list_task_comments - Get all comments on a task, including timestamps and authors
• add_task_comment - Add a comment to a task for updates, decisions, or notes

Time Tracking

• start_time_tracking - Start tracking time on a specific task
• stop_time_tracking - Stop the current time tracking session and log time to the task
• get_tracking_status - Check if time tracking is currently active and which task is being tracked

Quick Reference Table

Common Tools with Examples

list_tasks - Most Used

Search and filter your tasks:

"What tasks are due this week?"

See full reference →

create_task - Create New Work

Create tasks from conversations:

"Create a task to follow up with Acme Corp next week"

See full reference →

start_time_tracking - Track Work

Start timers automatically:

"Start tracking time on the login feature task"

See full reference →

Tool Naming Conventions

Corcava MCP tools follow consistent naming patterns:

Naming Pattern: verb_noun

• Read operations: list_*, get_* (e.g., list_tasks, get_task)
• Write operations: create_*, update_*, add_* (e.g., create_task, update_task)
• Destructive operations: delete_* (e.g., delete_task)
• Actions: start_*, stop_* (e.g., start_time_tracking)

Format: snake_case

All tool names use lowercase with underscores:

• ✅ list_tasks (correct)
• ✅ get_task (correct)
• ✅ start_time_tracking (correct)
• ❌ listTasks (incorrect - camelCase)
• ❌ get-task (incorrect - kebab-case)

Typical Error Responses

When tool calls fail, you'll receive structured error responses:

401 Unauthorized

Authentication failed:

{
  "error": "unauthorized",
  "message": "Invalid or expired API key"
}

400 Bad Request

Invalid parameters:

{
  "error": "validation_error",
  "message": "Missing required parameter: task_id",
  "field": "task_id"
}

404 Not Found

Resource doesn't exist:

{
  "error": "not_found",
  "message": "Task with ID 123 not found"
}

429 Rate Limited

Too many requests:

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Retry after 60 seconds",
  "retry_after": 60
}

Browse Individual Tool References

Each tool has a detailed reference page with:

• Purpose and use cases
• Input parameters and types
• Output format
• Example tool calls (JSON)
• Natural language prompt examples
• Edge cases and troubleshooting

See all tool references in the categories above, or use the quick reference table to find specific tools.

Getting Started

To use these tools, you need to:

1. Set up MCP integration - See the AI Assistant Integration (MCP) guide
2. Get an API key - Create one in Settings → Integrations → Public API
3. Configure your AI assistant - Add Corcava as an MCP server in Claude Desktop, Cursor, Windsurf, or Continue
4. Start using tools - Ask your AI assistant to list tasks, create tasks, or track time

For more information, see the main MCP integration page.