filter_tasks

filter_tasks

Filter tasks in OmniFocus by status, dates, projects, tags, and more. Use custom perspectives, search, and sorting to manage tasks effectively and focus on relevant priorities.

Instructions

Advanced task filtering with unlimited perspective combinations - status, dates, projects, tags, search, and more

Input Schema

Name	Required	Description
`completedAfter`	No	Show tasks completed after this date (ISO format: YYYY-MM-DD)
`completedBefore`	No	Show tasks completed before this date (ISO format: YYYY-MM-DD)
`completedThisMonth`	No	Show tasks completed this month
`completedThisWeek`	No	Show tasks completed this week
`completedToday`	No	Show tasks completed today
`deferAfter`	No	Show tasks with defer date after this date (ISO format: YYYY-MM-DD)
`deferAvailable`	No	Show tasks whose defer date has passed (now available)
`deferBefore`	No	Show tasks with defer date before this date (ISO format: YYYY-MM-DD)
`deferThisWeek`	No	Show tasks deferred to this week
`deferToday`	No	Show tasks deferred to today
`dueAfter`	No	Show tasks due after this date (ISO format: YYYY-MM-DD)
`dueBefore`	No	Show tasks due before this date (ISO format: YYYY-MM-DD)
`dueThisMonth`	No	Show tasks due this month
`dueThisWeek`	No	Show tasks due this week
`dueToday`	No	Show tasks due today
`estimateMax`	No	Maximum estimated minutes
`estimateMin`	No	Minimum estimated minutes
`exactTagMatch`	No	Set to true for exact tag name match, false for partial (default: false)
`flagged`	No	Filter by flagged status
`hasEstimate`	No	Filter tasks that have time estimates
`hasNote`	No	Filter tasks that have notes
`inInbox`	No	Filter tasks in inbox
`limit`	No	Maximum number of tasks to return (default: 100)
`overdue`	No	Show overdue tasks only
`perspective`	No	Limit search to specific perspective: inbox, flagged, all tasks
`projectFilter`	No	Filter by project name (partial match)
`searchText`	No	Search in task names and notes
`sortBy`	No	Sort results by field
`sortOrder`	No	Sort order (default: asc)
`tagFilter`	No	Filter by tag name(s). Can be single tag or array of tags
`taskStatus`	No	Filter by task status. Can specify multiple statuses

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "completedAfter": {
      "description": "Show tasks completed after this date (ISO format: YYYY-MM-DD)",
      "type": "string"
    },
    "completedBefore": {
      "description": "Show tasks completed before this date (ISO format: YYYY-MM-DD)",
      "type": "string"
    },
    "completedThisMonth": {
      "description": "Show tasks completed this month",
      "type": "boolean"
    },
    "completedThisWeek": {
      "description": "Show tasks completed this week",
      "type": "boolean"
    },
    "completedToday": {
      "description": "Show tasks completed today",
      "type": "boolean"
    },
    "deferAfter": {
      "description": "Show tasks with defer date after this date (ISO format: YYYY-MM-DD)",
      "type": "string"
    },
    "deferAvailable": {
      "description": "Show tasks whose defer date has passed (now available)",
      "type": "boolean"
    },
    "deferBefore": {
      "description": "Show tasks with defer date before this date (ISO format: YYYY-MM-DD)",
      "type": "string"
    },
    "deferThisWeek": {
      "description": "Show tasks deferred to this week",
      "type": "boolean"
    },
    "deferToday": {
      "description": "Show tasks deferred to today",
      "type": "boolean"
    },
    "dueAfter": {
      "description": "Show tasks due after this date (ISO format: YYYY-MM-DD)",
      "type": "string"
    },
    "dueBefore": {
      "description": "Show tasks due before this date (ISO format: YYYY-MM-DD)",
      "type": "string"
    },
    "dueThisMonth": {
      "description": "Show tasks due this month",
      "type": "boolean"
    },
    "dueThisWeek": {
      "description": "Show tasks due this week",
      "type": "boolean"
    },
    "dueToday": {
      "description": "Show tasks due today",
      "type": "boolean"
    },
    "estimateMax": {
      "description": "Maximum estimated minutes",
      "type": "number"
    },
    "estimateMin": {
      "description": "Minimum estimated minutes",
      "type": "number"
    },
    "exactTagMatch": {
      "description": "Set to true for exact tag name match, false for partial (default: false)",
      "type": "boolean"
    },
    "flagged": {
      "description": "Filter by flagged status",
      "type": "boolean"
    },
    "hasEstimate": {
      "description": "Filter tasks that have time estimates",
      "type": "boolean"
    },
    "hasNote": {
      "description": "Filter tasks that have notes",
      "type": "boolean"
    },
    "inInbox": {
      "description": "Filter tasks in inbox",
      "type": "boolean"
    },
    "limit": {
      "description": "Maximum number of tasks to return (default: 100)",
      "maximum": 1000,
      "type": "number"
    },
    "overdue": {
      "description": "Show overdue tasks only",
      "type": "boolean"
    },
    "perspective": {
      "description": "Limit search to specific perspective: inbox, flagged, all tasks",
      "enum": [
        "inbox",
        "flagged",
        "all"
      ],
      "type": "string"
    },
    "projectFilter": {
      "description": "Filter by project name (partial match)",
      "type": "string"
    },
    "searchText": {
      "description": "Search in task names and notes",
      "type": "string"
    },
    "sortBy": {
      "description": "Sort results by field",
      "enum": [
        "name",
        "dueDate",
        "deferDate",
        "completedDate",
        "flagged",
        "project"
      ],
      "type": "string"
    },
    "sortOrder": {
      "description": "Sort order (default: asc)",
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string"
    },
    "tagFilter": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      ],
      "description": "Filter by tag name(s). Can be single tag or array of tags"
    },
    "taskStatus": {
      "description": "Filter by task status. Can specify multiple statuses",
      "items": {
        "enum": [
          "Available",
          "Next",
          "Blocked",
          "DueSoon",
          "Overdue",
          "Completed",
          "Dropped"
        ],
        "type": "string"
      },
      "type": "array"
    }
  },
  "type": "object"
}

OmniFocus MCP Enhanced

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from OmniFocus MCP Enhanced

Related Tools

MCP directory API