OmniFocus

NPM · @SCARDIS/OMNIFOCUS-MCP · SCANNED AUG 3

Full CRUD MCP server for OmniFocus via Omni Automation — tasks, projects, folders, tags, recurrence.

Available components

+20 this week 63 63 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 114 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability77

AI-judged instruction clarity (excellent).Pass
Tool/resource definitions use about 2245 tokens (~83/item across 27 items; 27 tools + 0 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management0

Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified

Tool Coverage77

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
30% of tool parameters carry a description.Partial

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Unverified: 1 category

A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @scardis/omnifocus-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add steveardis-omnifocus -- npx -y @scardis/omnifocus-mcp

# add to Codex CLI

codex mcp add steveardis-omnifocus -- npx -y @scardis/omnifocus-mcp

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "steveardis-omnifocus": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@scardis/omnifocus-mcp"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add steveardis-omnifocus --command npx --arg -y --arg @scardis/omnifocus-mcp

# ~/.hermes/config.yaml

mcp_servers:
  steveardis-omnifocus:
    command: "npx"
    args: ["-y", "@scardis/omnifocus-mcp"]

// mcp.json

{
  "mcpServers": {
    "steveardis-omnifocus": {
      "command": "npx",
      "args": [
        "-y",
        "@scardis/omnifocus-mcp"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

2 Aug 26 +39
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. security
- Capabilities: pass → unverified ▼ functional
- Schema quality: unverified → excellent ▲ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- Licence: MIT functional
1 Aug 26 +5
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- MCP protocol: unverified → pass ▲ functional
31 Jul 26 −24
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
27 Jul 26 43

First indexed and scored.

Show 2 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/@scardis/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 95 packages

95 packages in the resolved dependency tree · 95 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 27 exposed · ~2,245 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

complete_project ~34

Mark a project as done (complete). Returns the updated project detail.

Input Output Examples

Name	Type	Req	Description
id	string	yes	The project's id.primaryKey

No output schema declared.

No examples provided.

complete_task ~36

Mark a task complete by its stable ID. Returns the updated task detail.

Input Output Examples

Name	Type	Req	Description
id	string	yes	The task's id.primaryKey

No output schema declared.

No examples provided.

create_folder ~55

Create a new OmniFocus folder. Omit parentFolderId to create at the top level; provide parentFolderId to nest it inside an existing folder.

Input Output Examples

Name	Type	Req	Description
name	string	yes	—
parentFolderId	string	—	—

No output schema declared.

No examples provided.

create_project ~135

Create a new OmniFocus project. Omit folderId to create at the top level; provide folderId to place it inside a folder. Optionally set type (parallel/sequential/singleActions), status (active/onHold), review interval, and tags.

Input Output Examples

Name	Type	Req	Description
deferDate	string	—	—
dueDate	string	—	—
flagged	boolean	—	—
folderId	string	—	—
name	string	yes	—
note	string	—	—
reviewInterval	object	—	—
status	string	—	—
tagIds	array	—	—
type	string	—	—

No output schema declared.

No examples provided.

create_tag ~55

Create a new OmniFocus tag. Omit parentTagId to create at the top level; provide parentTagId to nest it under an existing tag.

Input Output Examples

Name	Type	Req	Description
name	string	yes	—
parentTagId	string	—	—

No output schema declared.

No examples provided.

create_task ~140

Create a new task. Placement: omit projectId and parentTaskId for inbox; provide projectId to add to a project; provide parentTaskId to create a subtask. Providing both projectId and parentTaskId is an error.

Input Output Examples

Name	Type	Req	Description
deferDate	string	—	—
dueDate	string	—	—
estimatedMinutes	integer	—	—
flagged	boolean	—	—
name	string	yes	—
note	string	—	—
parentTaskId	—	—	—
plannedDate	string	—	—
projectId	string	—	—
repetitionRule	object	—	—
tagIds	array	—	—

No output schema declared.

No examples provided.

delete_folder ~88

Permanently and recursively delete an OmniFocus folder. THIS ACTION CANNOT BE UNDONE. The ENTIRE subtree is destroyed: all child folders, all projects within those folders, and all tasks within those projects. Before calling this tool you MUST ask the user to explicitly confirm they want to permanently delete the folder and all of its contents.

Input Output Examples

Name	Type	Req	Description
id	string	yes	The folder's id.primaryKey

No output schema declared.

No examples provided.

delete_project ~72

Permanently delete a project and ALL its tasks. THIS ACTION CANNOT BE UNDONE. Before calling this tool you MUST ask the user to explicitly confirm they want to permanently delete the project, and inform them that all tasks within the project will also be deleted.

Input Output Examples

Name	Type	Req	Description
id	string	yes	The project's id.primaryKey

No output schema declared.

No examples provided.

delete_tag ~82

Permanently delete an OmniFocus tag. THIS ACTION CANNOT BE UNDONE. All child tags are also deleted, and all tasks/projects that held this tag have it removed automatically. Before calling this tool you MUST ask the user to explicitly confirm they want to permanently delete the tag and all its child tags.

Input Output Examples

Name	Type	Req	Description
id	string	yes	The tag's id.primaryKey

No output schema declared.

No examples provided.

delete_task ~72

Permanently delete a task and all its subtasks. THIS ACTION CANNOT BE UNDONE. Before calling this tool you MUST ask the user to explicitly confirm they want to permanently delete the task, and inform them that all subtasks will also be deleted.

Input Output Examples

Name	Type	Req	Description
id	string	yes	The task's id.primaryKey

No output schema declared.

No examples provided.

drop_project ~32

Mark a project as dropped. Returns the updated project detail.

Input Output Examples

Name	Type	Req	Description
id	string	yes	The project's id.primaryKey

No output schema declared.

No examples provided.

drop_task ~36

Mark a task dropped by its stable ID. Returns the updated task detail.

Input Output Examples

Name	Type	Req	Description
id	string	yes	The task's id.primaryKey

No output schema declared.

No examples provided.

edit_folder ~32

Rename an existing OmniFocus folder by its ID.

Input Output Examples

Name	Type	Req	Description
id	string	yes	—
name	string	yes	—

No output schema declared.

No examples provided.

edit_project ~117

Edit an existing project. Only provided fields are changed. Pass null for deferDate, dueDate, or reviewInterval to clear them. When tagIds is provided it replaces the full tag set.

Input Output Examples

Name	Type	Req	Description
deferDate	—	—	—
dueDate	—	—	—
flagged	boolean	—	—
id	string	yes	—
name	string	—	—
note	string	—	—
reviewInterval	object	—	—
status	string	—	—
tagIds	array	—	—
type	string	—	—

No output schema declared.

No examples provided.

edit_tag ~55

Edit an existing OmniFocus tag. Provide id plus any combination of name (rename) and status (active/onHold/dropped).

Input Output Examples

Name	Type	Req	Description
id	string	yes	—
name	string	—	—
status	string	—	—

No output schema declared.

No examples provided.

edit_task ~127

Edit an existing task by its stable ID. Only fields included in the call are changed; omitted fields are left unchanged. When tagIds is provided it replaces the full tag set. Pass null for deferDate, dueDate, or estimatedMinutes to clear those fields.

Input Output Examples

Name	Type	Req	Description
deferDate	—	—	—
dueDate	—	—	—
estimatedMinutes	—	—	—
flagged	boolean	—	—
id	string	yes	—
name	string	—	—
note	string	—	—
plannedDate	—	—	—
repetitionRule	—	—	—
tagIds	array	—	—

No output schema declared.

No examples provided.

get_folder ~49

Get full detail for a folder by its stable ID. Returns path, parentId, status, child folder IDs, and immediate project IDs.

Input Output Examples

Name	Type	Req	Description
id	string	yes	The folder's id.primaryKey

No output schema declared.

No examples provided.

get_project ~50

Get full detail for a project by its stable ID. Returns note, folder path, status, type, dates, review metadata, and tag IDs.

Input Output Examples

Name	Type	Req	Description
id	string	yes	The project's id.primaryKey

No output schema declared.

No examples provided.

get_tag ~45

Get full detail for a tag by its stable ID. Returns path, parentId, status, and child tag IDs.

Input Output Examples

Name	Type	Req	Description
id	string	yes	The tag's id.primaryKey

No output schema declared.

No examples provided.

get_task ~77

Get full detail for a task by its stable ID. Returns note, status, flagged, defer/due/completion dates, estimated minutes, container info, tag IDs, and parentTaskId (null for top-level tasks, set to the parent task's ID for subtasks).

Input Output Examples

Name	Type	Req	Description
id	string	yes	The task's id.primaryKey

No output schema declared.

No examples provided.

list_folders ~131

List folders in OmniFocus. By default, all folders (active and dropped) are returned. Optional filter.status ('active' | 'dropped') restricts to that status. Results are capped at limit (default 200). Each folder includes id, name, full path (ancestors joined with ▸), parentId, and status.

Input Output Examples

Name	Type	Req	Description
filter	object	—	Optional filter. When status is provided, only folders with that status are returned. When omitted, all folders (active and dropped) are returned.
limit	integer	—	Maximum number of folders to return. Defaults to 200.

No output schema declared.

No examples provided.

list_projects ~135

List projects in OmniFocus. By default, done and dropped projects are excluded — pass filter.status to override. Optional filter fields: status (array of status strings), folderId (restricts to that folder's subtree), flagged (boolean). Results are capped at limit (default 100). Each project includes folderId and flagged in addition to id, name, folderPath, status, and type.

Input Output Examples

Name	Type	Req	Description
filter	object	—	Optional filters. All fields combine as AND. When status is omitted, done and dropped projects are excluded by default.
limit	integer	—	Maximum number of projects to return. Defaults to 100.

No output schema declared.

No examples provided.

list_tags ~143

List tags in OmniFocus. By default, all tags (active, onHold, and dropped) are returned. Optional filter.status ('active' | 'onHold' | 'dropped') restricts to that status. Results are capped at limit (default 200). Each tag includes id, name, full path (ancestors joined with ▸), parentId, and status.

Input Output Examples

Name	Type	Req	Description
filter	object	—	Optional filter. When status is provided, only tags with that status are returned. When omitted, all tags (active, onHold, and dropped) are returned.
limit	integer	—	Maximum number of tags to return. Defaults to 200.

No output schema declared.

No examples provided.

list_tasks ~192

List tasks in OmniFocus within a scope. Provide exactly one of: projectId (tasks in a project), folderId (tasks across all projects in a folder), inbox (inbox tasks), or all (every task). By default, complete and dropped tasks are excluded — pass filter.status to override. Optional filter fields: flagged (boolean), status (array of status strings), tagId (string), dueBeforeDate (ISO datetime). Results are capped at limit (default 200). Each returned task includes dueDate and tagIds.

Input Output Examples

Name	Type	Req	Description
filter	object	—	Optional filters. All fields combine as AND. When status is omitted, complete and dropped tasks are excluded by default.
limit	integer	—	Maximum number of tasks to return. Defaults to 200.
scope	object	yes	Exactly one of: projectId (string), folderId (string), inbox (true), or all (true)

No output schema declared.

No examples provided.

move_project ~67

Move a project to a different folder or to the top level. Pass folderId as a string to move into a folder, or null to move to the top level. Throws a not-found error if either ID does not exist.

Input Output Examples

Name	Type	Req	Description
folderId	—	yes	—
id	string	yes	—

No output schema declared.

No examples provided.

move_task ~78

Move a task to a different project (making it a top-level task) or make it a subtask of another task. Exactly one of projectId or parentTaskId must be provided. Throws a not-found error if any ID does not exist.

Input Output Examples

Name	Type	Req	Description
id	string	yes	—
parentTaskId	—	—	—
projectId	—	—	—

No output schema declared.

No examples provided.

resolve_name ~110

Resolve an entity name to its stable ID(s). Returns ALL matches — never silently picks one. If multiple candidates are returned, ask the user or caller to disambiguate using the path field before proceeding with a write operation.

Input Output Examples

Name	Type	Req	Description
query	string	yes	Exact name to search for
scope	string	—	Optional path prefix to narrow results, e.g. "Work ▸ Clients"
type	string	yes	The entity type to search: task, project, folder, tag, or perspective

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug