Autotask MCP Server

Instructions

Implementation Reference

• src/services/autotask.service.ts:1150-1163 (handler)

  Core handler function that performs the actual task creation using the Autotask API client.

  async createTask(task: Partial<AutotaskTask>): Promise<number> {
    const client = await this.ensureClient();
    
    try {
      this.logger.debug('Creating task:', task);
      const result = await client.tasks.create(task as any);
      const taskId = (result.data as any)?.id;
      this.logger.info(`Task created with ID: ${taskId}`);
      return taskId;
    } catch (error) {
      this.logger.error('Failed to create task:', error);
      throw error;
    }
  }

• src/handlers/tool.handler.ts:1009-1050 (schema)

  Input schema definition and tool metadata for the create_task tool, used for validation and documentation.

  {
    name: 'create_task',
    description: 'Create a new task in Autotask',
    inputSchema: {
      type: 'object',
      properties: {
        projectID: {
          type: 'number',
          description: 'Project ID for the task'
        },
        title: {
          type: 'string',
          description: 'Task title'
        },
        description: {
          type: 'string',
          description: 'Task description'
        },
        status: {
          type: 'number',
          description: 'Task status (1=New, 2=In Progress, 5=Complete)'
        },
        assignedResourceID: {
          type: 'number',
          description: 'Assigned resource ID'
        },
        estimatedHours: {
          type: 'number',
          description: 'Estimated hours for the task'
        },
        startDateTime: {
          type: 'string',
          description: 'Task start date/time (ISO format)'
        },
        endDateTime: {
          type: 'string',
          description: 'Task end date/time (ISO format)'
        }
      },
      required: ['projectID', 'title', 'status']
    }
  }

• src/handlers/tool.handler.ts:1051-1055 (registration)

  The listTools method registers the create_task tool by including it in the returned list of available MCP tools.

    ];
  
    this.logger.debug(`Listed ${tools.length} available tools`);
    return tools;
  }

• src/handlers/tool.handler.ts:1168-1171 (handler)

  Dispatch handler in callTool method that routes create_task calls to the autotaskService.createTask method.

  case 'create_task':
    result = await this.autotaskService.createTask(args);
    message = `Successfully created task with ID: ${result}`;
    break;