Clockify MCP Server

Instructions

Implementation Reference

• src/index.ts:1324-1342 (handler)

  The handler function that implements the core logic for the 'create_tag' tool. It sends a POST request to the Clockify API to create a new tag in the specified workspace and returns a formatted success response with the new tag's ID, name, and archived status.

  private async createTag(args: any) {
    const { workspaceId, ...tagData } = args;
  
    const tag = await this.makeRequest(
      `/workspaces/${workspaceId}/tags`,
      "POST",
      tagData
    );
  
    return {
      content: [
        {
          type: "text",
          text: `Tag created successfully!\nID: ${tag.id}\nName: ${tag.name}\nArchived: ${tag.archived}`,
        },
      ],
      isError: false,
    };
  }

• src/index.ts:608-619 (registration)

  The tool registration entry in the listTools response, defining the name, description, and input schema for the 'create_tag' tool.

    name: "create_tag",
    description: "Create a new tag",
    inputSchema: {
      type: "object",
      properties: {
        workspaceId: { type: "string", description: "Workspace ID" },
        name: { type: "string", description: "Tag name" },
        archived: { type: "boolean", description: "Whether tag is archived (optional)" },
      },
      required: ["workspaceId", "name"],
    },
  },

• src/index.ts:799-801 (registration)

  The dispatch logic in the CallToolRequestHandler switch statement that validates input and calls the createTag handler method.

  case "create_tag":
    if (!args?.workspaceId) throw new McpError(ErrorCode.InvalidParams, 'workspaceId is required');
    return await this.createTag(args as any);

• src/index.ts:610-618 (schema)

  The input schema defining the parameters for the 'create_tag' tool: workspaceId (required string), name (required string), archived (optional boolean).

  inputSchema: {
    type: "object",
    properties: {
      workspaceId: { type: "string", description: "Workspace ID" },
      name: { type: "string", description: "Tag name" },
      archived: { type: "boolean", description: "Whether tag is archived (optional)" },
    },
    required: ["workspaceId", "name"],
  },