list_perspectives

MCP tool from OmniFocus MCP by themotionmachine

List available perspectives, both built-in and custom (custom perspectives are an OmniFocus Pro feature).

How to use it

list_perspectives is exposed by the OmniFocus MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the list_perspectives tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.

Install OmniFocus MCP

$claude mcp add omnifocus -- npx -y omnifocus-mcp

FULL OMNIFOCUS MCP LISTING

Other tools in OmniFocus MCP (29)

add_omnifocus_task

Create a new task.

add_project

Create a new project.

batch_add_items

Create multiple tasks and projects in one operation. Each item accepts the same fields as addomnifocustask / addproject, plus type (task or project) and optional hierarchy helpers:

batch_remove_items

Remove multiple tasks or projects in one operation. Each item takes id or name, plus itemType.

create_tag

Create a tag, optionally nested under an existing parent.

dump_database

Get the complete state of your database. Use for comprehensive analysis; prefer queryomnifocus for anything targeted.

edit_item

Edit an existing task or project. Also the way to move items — set newProjectName to move a task into a project, or to ""/"inbox" to send it to the inbox.

entity

What to query: tasks, projects, or folders

folderName

(optional): folder to place the project in

get_perspective_view

Get the items visible in a named perspective.

hideCompleted

(optional): hide completed/dropped tasks (default: true)

hideRecurringDuplicates

(optional): hide duplicate instances of recurring tasks (default: true)

or name: which item to edit (id takes precedence)

includeBuiltIn

, includeCustom (optional, default: true)

includeDropped

(optional, default: false)

itemType

task or project

limit

(optional, default: 100), includeMetadata (optional), fields (optional)

list_tags

List all tags with their hierarchy, active status, and task counts.

name

note

, dueDate, deferDate, plannedDate, flagged, estimatedMinutes, tags (all optional)

parentTagName

/ parentTagID (optional; ID takes precedence)

parentTaskId

/ parentTaskName (optional): nest under an existing task

parentTempId

nest this item under another batch item's tempId

perspectiveName

e.g. Inbox, Flagged, or a custom perspective name

projectName

(optional): project to add the task to (defaults to inbox)

query_omnifocus

Query tasks, projects, or folders with targeted filters — much faster and lighter than dumping the whole database. See QUERYTOOLREFERENCE.md for the full reference and QUERYTOOLEXAMPLES.md for worked examples.

remove_item

Remove a task or project.

sequential

(optional): whether tasks must be completed in order

tempId

a temporary ID other items in the same batch can reference