Find similar tasks
find_similar_tasksRead-only
Find existing OmniFocus tasks with similar names before creating a new one. Returns ranked matches with similarity scores to reuse an existing task and avoid duplicates.
Instructions
Find existing OmniFocus tasks whose names are similar to a proposed new task name. Run this BEFORE creating a task that might already exist — it returns ranked matches with similarity scores and task IDs so you can reuse an existing task instead of creating a duplicate. Tolerant of typos, word reordering, and partial names.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | The task name you are about to create. Existing tasks are ranked by how closely their names match this. | |
| fresh | No | Bypass the process-local cache. Other clients and GUI changes may otherwise remain cached for the advertised TTL. | |
| limit | No | Maximum number of matches to return (1-20). Default 5. | |
| minScore | No | Minimum similarity score (0-1) a task must reach to be listed. Default 0.35. Raise it (e.g. 0.6) for near-exact matches only; lower it to cast a wider net. | |
| includeCompleted | No | Also search completed and dropped tasks. Default false — a finished task is rarely the one you want to reuse, but this is useful for checking whether something was already done. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| meta | No | ||
| tool | Yes | ||
| success | Yes |