todo4 docsBack to home
Connect your agent

OpenClaw

Three paths, same result: a chat-driven skill install, an npm plugin, or a manual wiring with MCPorter — pick whichever matches how you already work.

Method 1 — Skill (recommended)

Paste a prompt in chat. Email OTP, no browser, no CLI. Best for first-time users.

Method 2 — Plugin (npm)

Install an npm plugin that ships the onboarding tools and skill. Two commands, then chat.

Method 3 — MCPorter (CLI)

Manual setup with terminal commands. Best if you already use MCPorter or want OAuth-only auth.

Method 1 — Install via Skill

OpenClaw fetches the /todo4-onboard skill from GitHub and runs it. The skill creates your todo4 account via email OTP, then writes the MCP config and agent token automatically. No browser tab, no token paste.

Paste this in chat

Install and set me up with Todo4: https://github.com/panitw/todo4-onboard-skill
  1. 1Open OpenClaw on your machine.
  2. 2Paste the prompt above into a new chat.
  3. 3When asked, provide your email — todo4 sends a 6-digit verification code.
  4. 4Paste the code back into chat. OpenClaw connects itself automatically (account, MCP config, and agent token are all wired up for you).

Already installed the skill on a previous OpenClaw session? Just say “Set me up with todo4”.

Method 2 — Install via Plugin

The plugin @panitw/todo4-openclaw-plugin registers four todo4 agent tools and installs a todo4-onboard skill into ~/.openclaw/skills/. After you restart the gateway, just ask the agent to onboard you in chat.

  1. 1

    Install the todo4 plugin from npm.

    openclaw plugins install @panitw/todo4-openclaw-plugin
  2. 2

    Restart the gateway so OpenClaw loads the plugin tools and the bundled onboarding skill.

    openclaw gateway restart
  3. 3

    In chat, ask the agent to onboard you. The bundled todo4-onboard skill walks you through email OTP, verifies the code, and wires up MCP automatically.

    Try any of:
    • “Run the todo4-onboard skill”
    • “Set me up with todo4”
    • “Sign me up for todo4”

Method 3 — Install via MCPorter

For users who prefer terminal-based MCP server management. Uses standard OAuth (browser-based sign-in) instead of email OTP.

  1. 1

    Make sure OpenClaw is installed.

    See github.com/openclaw/openclaw for installation instructions.
  2. 2

    Install MCPorter (Node.js 20+ required).

    npm install -g mcporter
  3. 3

    Add todo4 to MCPorter.

    mcporter config add todo4 --url https://todo4.io/mcp --scope home --auth oauth
  4. 4

    Authenticate. A browser tab opens for todo4 sign-in — approve the request.

    mcporter auth todo4
  5. 5

    Restart the OpenClaw gateway so it picks up the new MCP server.

    openclaw gateway restart

Test your connection

Back in OpenClaw, try one of these:

  • “List my todo4 tasks.”
  • “Create a task to review the Q2 report by Friday, p2.”
  • “What’s on my plate this week?”

Don’t have a todo4 account yet?

Method 1 creates one for you via email OTP. Or sign up first if you prefer.

Sign up freeSign in

Troubleshooting

The skill doesn’t install or run

Make sure your OpenClaw version supports remote skill install from GitHub. If not, upgrade to the latest release or fall back to Method 2.

I never received the verification code

Check your spam folder. The skill rate-limits resends — if you hit the limit, wait a minute and ask the skill to send a new code.

MCPorter says “todo4 already exists”

You’ve already added the connector. Run mcporter auth todo4 to refresh authentication, or remove it first with mcporter config remove todo4.

Tools don’t show up after install

Make sure you ran openclaw gateway restart so OpenClaw picks up the new MCP server.