create_project
Create a new project in Clockify to organize time tracking, set billing options, and manage client assignments within a workspace.
Instructions
Create a new project
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| workspaceId | Yes | Workspace ID | |
| name | Yes | Project name | |
| clientId | No | Client ID (optional) | |
| isPublic | No | Whether project is public (optional) | |
| billable | No | Whether project is billable (optional) | |
| color | No | Project color (hex code, optional) | |
| estimate | No | Project estimate (optional) |
Implementation Reference
- src/index.ts:1033-1051 (handler)The core handler function for the 'create_project' tool. It extracts parameters, makes a POST request to the Clockify API endpoint `/workspaces/{workspaceId}/projects`, and returns a success message with project details.
private async createProject(args: any) { const { workspaceId, ...projectData } = args; const project = await this.makeRequest( `/workspaces/${workspaceId}/projects`, "POST", projectData ); return { content: [ { type: "text", text: `Project created successfully!\nID: ${project.id}\nName: ${project.name}\nClient: ${project.clientName || "No client"}\nPublic: ${project.public}\nBillable: ${project.billable}`, }, ], isError: false, }; } - src/index.ts:385-406 (schema)The input schema definition for the 'create_project' tool, specifying parameters like workspaceId, name, clientId, etc., used in tool discovery via ListTools.
name: "create_project", description: "Create a new project", inputSchema: { type: "object", properties: { workspaceId: { type: "string", description: "Workspace ID" }, name: { type: "string", description: "Project name" }, clientId: { type: "string", description: "Client ID (optional)" }, isPublic: { type: "boolean", description: "Whether project is public (optional)" }, billable: { type: "boolean", description: "Whether project is billable (optional)" }, color: { type: "string", description: "Project color (hex code, optional)" }, estimate: { type: "object", properties: { estimate: { type: "string", description: "Estimate duration (ISO 8601 duration)" }, type: { type: "string", enum: ["AUTO", "MANUAL"], description: "Estimate type" }, }, description: "Project estimate (optional)", }, }, required: ["workspaceId", "name"], }, - src/index.ts:751-753 (registration)Registration of the 'create_project' handler in the CallToolRequestSchema switch statement, dispatching calls to the createProject method.
case "create_project": if (!args?.workspaceId) throw new McpError(ErrorCode.InvalidParams, 'workspaceId is required'); return await this.createProject(args as any); - src/index.ts:28-40 (schema)TypeScript interface defining the Project structure, matching the input schema for create_project.
interface Project { id?: string; name: string; clientId?: string; workspaceId: string; isPublic?: boolean; billable?: boolean; color?: string; estimate?: { estimate: string; type: "AUTO" | "MANUAL"; }; }