Harvest MCP Server

Instructions

Implementation Reference

• src/harvest-client.ts:97-101 (handler)

  Core handler function that performs the DELETE request to the Harvest API to delete the specified time entry.

  async deleteTimeEntry(id: string) {
    return this.makeRequest(`/time_entries/${id}`, {
      method: 'DELETE',
    });
  }

• src/index.ts:117-126 (handler)

  MCP server tool execution handler case that invokes the HarvestClient deleteTimeEntry method and formats the success response.

  case 'harvest_delete_time_entry':
    await harvestClient.deleteTimeEntry(typedArgs.id as string);
    return {
      content: [
        {
          type: 'text',
          text: `Time entry ${typedArgs.id} deleted successfully`,
        },
      ],
    };

• src/tools.ts:52-61 (schema)

  Tool schema definition including name, description, and input validation schema requiring 'id' parameter.

    name: 'harvest_delete_time_entry',
    description: 'Delete a time entry. Use about {"tool": "harvest_delete_time_entry"} for detailed usage and warnings.',
    inputSchema: {
      type: 'object',
      properties: {
        id: { type: 'string', description: 'Time entry ID to delete' }
      },
      required: ['id']
    }
  },

• src/index.ts:69-73 (registration)

  Registration of all tools list endpoint, which includes the harvest_delete_time_entry tool schema from tools.ts.

  server.setRequestHandler(ListToolsRequestSchema, async () => {
    return {
      tools: tools,
    };
  });