linear_updateProject
Modify an existing Linear project by updating its name, description, or status to reflect current progress and requirements.
Instructions
Update an existing project in Linear
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "linear_updateProject"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ID of the project to update | |
| name | No | New name of the project | |
| description | No | New description of the project (Markdown supported) | |
| state | No | New state of the project (e.g., 'planned', 'started', 'paused', 'completed', 'canceled') |
Implementation Reference
- The handler function for the linear_updateProject tool. It validates the input arguments using the isUpdateProjectArgs type guard and calls linearService.updateProject to perform the update.
export function handleUpdateProject(linearService: LinearService) { return async (args: unknown) => { try { if (!isUpdateProjectArgs(args)) { throw new Error("Invalid arguments for updateProject"); } return await linearService.updateProject(args); } catch (error) { logError("Error updating project", error); throw error; } }; - MCPToolDefinition for linear_updateProject, defining input schema (requires project id, optional name/description/state) and output schema.
export const updateProjectToolDefinition: MCPToolDefinition = { name: "linear_updateProject", description: "Update an existing project in Linear", input_schema: { type: "object", properties: { id: { type: "string", description: "ID of the project to update", }, name: { type: "string", description: "New name of the project", }, description: { type: "string", description: "New description of the project (Markdown supported)", }, state: { type: "string", description: "New state of the project (e.g., 'planned', 'started', 'paused', 'completed', 'canceled')", }, }, required: ["id"], }, output_schema: { type: "object", properties: { id: { type: "string" }, name: { type: "string" }, description: { type: "string" }, state: { type: "string" }, url: { type: "string" } } } }; - src/tools/handlers/index.ts:67-70 (registration)Registration of the linear_updateProject handler within the registerToolHandlers function's return map, mapping it to handleUpdateProject curried with linearService.
// Project Management tools linear_updateProject: handleUpdateProject(linearService), linear_addIssueToProject: handleAddIssueToProject(linearService), linear_getProjectIssues: handleGetProjectIssues(linearService), - src/tools/type-guards.ts:416-431 (helper)Type guard function isUpdateProjectArgs that validates the input arguments match the expected shape for the linear_updateProject tool.
export function isUpdateProjectArgs(args: unknown): args is { id: string; name?: string; description?: string; state?: string; } { return ( typeof args === "object" && args !== null && "id" in args && typeof (args as { id: string }).id === "string" && (!("name" in args) || typeof (args as { name: string }).name === "string") && (!("description" in args) || typeof (args as { description: string }).description === "string") && (!("state" in args) || typeof (args as { state: string }).state === "string") ); }