harvest_list_tasks
Retrieve and filter tasks from Harvest time tracking with options for active status, pagination, and results per page.
Instructions
List all tasks with filtering options. Use about {"tool": "harvest_list_tasks"} for detailed parameters and examples.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| is_active | No | Filter by active status | |
| page | No | Page number | |
| per_page | No | Results per page (max 100) |
Implementation Reference
- src/tools.ts:130-141 (registration)Tool registration in the tools array, including name, description, and input schema definition.{ name: 'harvest_list_tasks', description: 'List all tasks with filtering options. Use about {"tool": "harvest_list_tasks"} for detailed parameters and examples.', inputSchema: { type: 'object', properties: { is_active: { type: 'boolean', description: 'Filter by active status' }, page: { type: 'number', description: 'Page number' }, per_page: { type: 'number', description: 'Results per page (max 100)' } } } },
- src/index.ts:199-208 (handler)MCP server request handler for the tool, which delegates to HarvestClient.getTasks() and formats the response as JSON text.case 'harvest_list_tasks': const tasks = await harvestClient.getTasks(typedArgs); return { content: [ { type: 'text', text: JSON.stringify(tasks, null, 2), }, ], };
- src/harvest-client.ts:127-130 (helper)Core implementation method in HarvestClient that makes the API request to /tasks endpoint with query parameters.async getTasks(options?: any) { const queryString = this.buildQueryString(options); return this.makeRequest(`/tasks${queryString}`); }
- src/harvest-client.ts:599-641 (helper)Detailed documentation and usage examples for the harvest_list_tasks tool provided by the about handler.'harvest_list_tasks': `# harvest_list_tasks Lists all tasks available in your Harvest account. ## Purpose Retrieve task information needed for creating time entries and understanding work categories. ## Parameters - \`is_active\` (boolean, optional): Filter by active/inactive status - \`page\` (number, optional): Page number for pagination - \`per_page\` (number, optional): Results per page, max 100 ## Example Usage **List all active tasks:** \`\`\`json { "tool": "harvest_list_tasks", "is_active": true } \`\`\` **List all tasks with pagination:** \`\`\`json { "tool": "harvest_list_tasks", "page": 1, "per_page": 50 } \`\`\` ## Response Format Returns an object with: - \`tasks\`: Array of task objects - Pagination information Each task includes: id, name, billable_by_default, is_active, is_default, hourly_rate, created_at, updated_at. ## Important Notes - Tasks are global but must be assigned to projects - Use harvest_list_task_assignments to see which tasks are available for a specific project - Not all tasks are valid for all projects`,