Jules MCP Server

Instructions

Implementation Reference

• src/mcp/tools.ts:329-353 (handler)

  The core handler function for the 'list_schedules' tool. It retrieves all scheduled tasks from storage, formats them with details like next run time and truncated prompt, and returns a JSON object with count and list of schedules.

  async listSchedules(): Promise<string> {
    return this.executeWithErrorHandling(async () => {
      const tasks = await this.storage.listTasks();
  
      const formatted = tasks.map((task) => {
        const nextRun = this.scheduler.getNextInvocation(task.id);
        return {
          id: task.id,
          name: task.name,
          cron: task.cron,
          enabled: task.enabled,
          repository: task.taskPayload.source,
          prompt: smartTruncate(task.taskPayload.prompt, 60),
          nextRun: nextRun?.toISOString() || 'Not scheduled',
          lastRun: task.lastRun || 'Never',
          lastSessionId: task.lastSessionId,
        };
      });
  
      return {
        count: formatted.length,
        schedules: formatted,
      };
    });
  }

• src/index.ts:287-294 (registration)

  Tool registration in the ListToolsRequest handler, defining the name, description, and empty input schema for 'list_schedules'.

  {
    name: 'list_schedules',
    description: 'List all locally-managed scheduled tasks',
    inputSchema: {
      type: 'object',
      properties: {},
    },
  },

• src/index.ts:340-343 (registration)

  Dispatch logic in the CallToolRequest handler that routes 'list_schedules' calls to the JulesTools.listSchedules method.

  case 'list_schedules': {
    result = await this.tools.listSchedules();
    break;
  }