Job ManagementRead-only

List Jobs

list_jobs

List sync job history. Three modes: (1) Pass feedId to list that feed's jobs only, newest first. Use the status filter to check for running jobs before triggering a new sync. (2) Omit feedId to list recent jobs across every feed in the workspace. (3) Set scope='family' on an accountant's parent workspace to also span portals — each row carries workspaceId, feedId, feedName, and a portal badge.

Try asking

“Show my recent sync jobs.”

Parameters

Parameter	Type	Required	Description
`workspaceId`	string	required	Workspace ID — get from list_workspaces. Portal workspaces are valid here when you manage them (look for `isInherited: true` in list_workspaces).
`feedId`	string	optional	Optional. Pass to filter to one feed; omit to list across every feed in the workspace.
`scope`	'self' \| 'family'	optional	Only meaningful when feedId is omitted. 'self' (default): jobs across this workspace's feeds. 'family': also include portals. Requires admin+ role; top-level workspaces only.
`limit`	number	optional	Max results (default 20, single-feed mode)
`limitPerFeed`	number	optional	When listing across feeds (no feedId), cap results per feed. Default 5, max 25.
`status`	enum	optional	Single-feed mode only. Filter: created, in_progress, paused, completed, failed, cancelled

Example call

The tool call an MCP client sends (required arguments shown with placeholder values).

{
  "tool": "list_jobs",
  "arguments": {
    "workspaceId": "workspaceId_123"
  }
}

Use this tool in

Claude Code Claude Desktop Claude Cowork ChatGPT Cursor Windsurf VS Code Copilot OpenClaw Gemini Hermes Agent

Related Job Management tools

Get Jobget_jobGet sync job status and progress Trigger Synctrigger_syncStart a new sync job Trigger Learntrigger_learnTrigger memory enrichment learning Cancel Jobcancel_jobCancel a running sync job

← All tools