harvest_list_projects

Retrieve and filter projects from Harvest time tracking system to manage project visibility and access client-specific data.

Instructions

List all projects with filtering options. Use about {"tool": "harvest_list_projects"} for detailed parameters and examples.

Input Schema

TableJSON Schema

Name	Required	Description
`is_active`	No	Filter by active status
`client_id`	No	Filter by client ID
`page`	No	Page number
`per_page`	No	Results per page (max 100)

Implementation Reference

src/index.ts:176-185 (handler)

MCP server handler dispatches to HarvestClient.getProjects with tool arguments and formats response as JSON text content.

case 'harvest_list_projects':
  const projects = await harvestClient.getProjects(typedArgs);
  return {
    content: [
      {
        type: 'text',
        text: JSON.stringify(projects, null, 2),
      },
    ],
  };

src/tools.ts:105-116 (schema)

Tool definition with name, description, and input schema for MCP registration and validation.

  name: 'harvest_list_projects',
  description: 'List all projects with filtering options. Use about {"tool": "harvest_list_projects"} for detailed parameters and examples.',
  inputSchema: {
    type: 'object',
    properties: {
      is_active: { type: 'boolean', description: 'Filter by active status' },
      client_id: { type: 'string', description: 'Filter by client ID' },
      page: { type: 'number', description: 'Page number' },
      per_page: { type: 'number', description: 'Results per page (max 100)' }
    }
  }
},

src/harvest-client.ts:117-120 (helper)

Core implementation fetches projects from Harvest API endpoint /projects with built query parameters.

async getProjects(options?: any) {
  const queryString = this.buildQueryString(options);
  return this.makeRequest(`/projects${queryString}`);
}

src/index.ts:69-73 (registration)
Registers all tools (including harvest_list_projects) for MCP listTools request handling.
```
server.setRequestHandler(ListToolsRequestSchema, async () => {
  return {
    tools: tools,
  };
});
```

src/harvest-client.ts:59-72 (helper)

Utility method builds query string from filter parameters used by getProjects.

private buildQueryString(params?: Record<string, any>): string {
  if (!params) return '';
  
  const queryParams = new URLSearchParams();
  Object.entries(params).forEach(([key, value]) => {
    if (value !== undefined && value !== null) {
      queryParams.append(key, String(value));
    }
  });
  
  const queryString = queryParams.toString();
  return queryString ? `?${queryString}` : '';
}

Harvest MCP Server