Clockify MCP Server

Instructions

Implementation Reference

• src/index.ts:1306-1321 (handler)

  The handler function that performs the DELETE request to the Clockify API endpoint for deleting a client and returns a success message.

  private async deleteClient(workspaceId: string, clientId: string) {
    await this.makeRequest(
      `/workspaces/${workspaceId}/clients/${clientId}`,
      "DELETE"
    );
  
    return {
      content: [
        {
          type: "text",
          text: `Client ${clientId} deleted successfully!`,
        },
      ],
      isError: false,
    };
  }

• src/index.ts:596-603 (schema)

  Input schema defining the required parameters: workspaceId and clientId for the delete_client tool.

  inputSchema: {
    type: "object",
    properties: {
      workspaceId: { type: "string", description: "Workspace ID" },
      clientId: { type: "string", description: "Client ID" },
    },
    required: ["workspaceId", "clientId"],
  },

• src/index.ts:593-604 (registration)

  Registration of the delete_client tool in the list of tools returned by ListToolsRequestHandler, including name, description, and schema.

  {
    name: "delete_client",
    description: "Delete a client",
    inputSchema: {
      type: "object",
      properties: {
        workspaceId: { type: "string", description: "Workspace ID" },
        clientId: { type: "string", description: "Client ID" },
      },
      required: ["workspaceId", "clientId"],
    },
  },

• src/index.ts:794-796 (registration)

  Dispatch case in the CallToolRequestHandler switch statement that validates arguments and calls the deleteClient handler method.

  case "delete_client":
    if (!args?.workspaceId || !args?.clientId) throw new McpError(ErrorCode.InvalidParams, 'workspaceId and clientId are required');
    return await this.deleteClient(args.workspaceId as string, args.clientId as string);

• src/index.ts:51-56 (schema)

  TypeScript interface defining the Client object structure used in the codebase.

  interface Client {
    id?: string;
    name: string;
    workspaceId: string;
    archived?: boolean;
  }