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
`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`,

Harvest MCP Server