TaskTraceMCPPlugin
TaskTraceMCPPlugin is the standalone public packaging repo for connecting the local TaskTrace desktop app to MCP-capable clients and the OpenClaw channel runtime.
Full documentation — resources, tools, installation, and configuration — is at tasktrace.com/docs.
It currently includes packaging for:
- OpenClaw native channel runtime
- OpenClaw MCP setup files
- Claude Code local plugins
- Codex local plugins
- Cursor-compatible bundle metadata
- generic
.mcp.json stdio server wiring
The MCP server itself is still the TaskTrace desktop app. Every MCP client path here launches:
/Applications/TaskTrace.app/Contents/MacOS/TaskTrace --mcp-stdio
The OpenClaw channel runtime in this repo separately opens a Unix-domain socket to the local TaskTrace app so agent actions can exchange live messages over the tasktrace channel.
The channel bridge now auto-discovers the standard TaskTrace socket paths for prod, local, and dev builds. If you need to force a specific app instance, set TASKTRACE_SOCKET_PATH before starting the OpenClaw gateway.
Important packaging note: in current OpenClaw builds, openclaw plugins install . installs the native plugin and channel runtime, but it does not automatically register the TaskTrace stdio MCP server from .mcp.json. You must add that MCP server separately with openclaw mcp set ....
Repository layout
-
package.json
Package metadata for local install, npm pack, publication, and the OpenClaw runtime registration.
-
openclaw.plugin.json
Native OpenClaw plugin manifest for the TaskTrace channel bridge.
-
index.js and src/
Native OpenClaw runtime entrypoint plus the Unix-socket bridge and TaskTrace agent session handler.
-
.claude-plugin/plugin.json
Claude Code plugin manifest with inline mcpServers config.
-
.cursor-plugin/plugin.json
Cursor-compatible plugin marker.
-
.codex-plugin/plugin.json
Codex plugin manifest that registers TaskTrace as an MCP server.
-
.codex-plugin/marketplace.json
Reference marketplace entry for a home-local Codex install.
-
.mcp.json
Reusable MCP server config in standard mcpServers format, including the Codex plugin install.
-
scripts/set-version.mjs
Semver-backed helper that validates a version and syncs it across package metadata and manifests.
Docs reviewed
Current packaging state
What was verified locally on April 3, 2026:
openclaw plugins install . succeeded on OpenClaw 2026.3.13openclaw plugins inspect tasktrace-mcp showed the plugin was discovered and enabledopenclaw mcp set tasktrace '{"command":"/Applications/TaskTrace.app/Contents/MacOS/TaskTrace","args":["--mcp-stdio"]}' registered the TaskTrace stdio MCP server in OpenClaw confignpm pack produced a working install artifact and openclaw plugins install ./tasktrace-mcp-0.1.0.tgz also succeededclaude --plugin-dir . --version accepted the local plugin layout- the native
tasktrace channel connected to the local TaskTrace socket and returned structured JSON responses
What still needs product-level QA on a normal TaskTrace machine:
- a full end-to-end OpenClaw embedded-agent turn that uses both the bundled TaskTrace MCP server and the native channel bridge
- a full end-to-end Claude plugin session using this standalone repo
- runtime validation on a machine where TaskTrace launches cleanly from
/Applications
Install and test
OpenClaw
Install from a local checkout:
git clone https://github.com/warrenronsiek/TaskTraceMCPPlugin.git
cd TaskTraceMCPPlugin
npm pack
openclaw plugins install .
openclaw mcp set tasktrace '{"command":"/Applications/TaskTrace.app/Contents/MacOS/TaskTrace","args":["--mcp-stdio"]}'
openclaw config set tools.profile '"full"' --strict-json
openclaw config unset tools.allow
openclaw gateway restart
openclaw mcp list
openclaw channels list
openclaw plugins list
openclaw plugins inspect tasktrace-mcp
Install from the packed archive instead:
warrenronsiek