# How to connect Todoist to Hermes

> Connect Todoist to Hermes in one click. 8 Todoist tools your agent can call from chat. No API keys.

Web version: https://claw-link.dev/hermes/todoist

ClawLink gives Hermes a more practical Todoist setup than rolling your own integration. Pair once in the browser and your always-on Hermes agent can act on Todoist for you — reading and doing real work on your behalf with no auth, token refresh, or tool wiring to build yourself.

## Todoist MCP for Hermes

Looking for a Todoist MCP server for Hermes Agent? ClawLink connects Todoist to Hermes Agent and exposes 8 Todoist tools your agent can call over [MCP](https://claw-link.dev/learn/what-is-an-mcp-server), with [hosted auth](https://claw-link.dev/learn/oauth-for-ai-agents) and nothing to run or maintain yourself. Using OpenClaw instead? The [OpenClaw Todoist integration](https://claw-link.dev/openclaw/todoist) works the same way.

**Start here — paste this into Hermes to set up ClawLink:**

> Set up ClawLink for Hermes and tell me when it's ready.
> 1. Install the plugin: `hermes plugins install ClawLink-HQ/hermes-plugin --enable`
> 2. Start pairing with `hermes clawlink begin`. It prints an approval link, so show me the link and stop, don't wait.
> 3. I'll approve it in my browser, then reply "approved".
> 4. When I say approved, finish setup: `hermes clawlink finish`
> 5. Then run `hermes clawlink test` and tell me whether ClawLink is ready.

## Setup

It takes three steps to connect Hermes to Todoist.

1. **Install ClawLink** — add the plugin to Hermes Agent once.
2. **Connect Todoist** — one-click OAuth in the ClawLink dashboard.
3. **Use it from chat** — ask Hermes Agent in plain English.

**Alternative for any agent (no plugin needed):** if the Hermes Agent plugin route isn't available or doesn't work, any AI agent with shell access can use the ClawLink CLI instead:

```bash
npx -y @useclawlink/cli login          # sign in via browser — no API key to paste
npx -y @useclawlink/cli connect todoist  # connect Todoist (browser OAuth)
npx -y @useclawlink/cli actions todoist  # list available actions
npx -y @useclawlink/cli run todoist <action> --input '<json>'  # execute (add --confirm for writes)
```

## What the Hermes Agent Todoist integration can do

8 Todoist tools are ready for Hermes Agent once the account is connected.

### All 8 Todoist tools for Hermes

| Tool | What it does |
|---|---|
| **Get all tasks** `todoist_get_all_tasks` | Fetches all incomplete tasks from Todoist |
| **Get all projects** `todoist_get_all_projects` | Get all projects from a Todoist account |
| **Filter tasks** `todoist_filter_tasks` | Get all tasks matching a filter |
| **Get all comments** `todoist_get_all_comments` | Retrieve all comments for a task or project |
| **Bulk create tasks** `todoist_bulk_create_tasks` | Create many tasks in one request |
| **Close task v1** `todoist_close_task_v1` | Close (complete) a task in Todoist |
| **Archive project2** `todoist_archive_project2` | Archive a project in Todoist |
| **Add workspace** `todoist_add_workspace` | Create a new workspace in Todoist |

## Example prompts

**Get All Tasks**

> Pull the relevant data from Todoist, summarize it in plain English, and point out anything that needs attention.

**Get All Projects**

> Pull the relevant data from Todoist, summarize it in plain English, and point out anything that needs attention.

**Filter Tasks**

> Use Todoist to filter tasks and walk me through the result in plain English.

**Get All Comments**

> Pull the relevant data from Todoist, summarize it in plain English, and point out anything that needs attention.

## ClawLink vs. building it yourself

The alternative to ClawLink is usually manual OAuth app setup plus your own token handling, permission troubleshooting, and tool plumbing for Hermes Agent. That is fine if you want to build and maintain the integration yourself. Most teams just want Todoist working from chat.

| | Manual | ClawLink |
|---|---|---|
| **Connection flow** | Register a Todoist app, configure redirect URLs, manage consent details, and reconnect users when auth settings drift. | Users connect Todoist through the hosted browser flow and ClawLink keeps the token lifecycle out of your app code. |
| **Ongoing maintenance** | You own refresh logic, permission debugging, environment config, and every provider-specific edge case for Todoist. | ClawLink handles the repetitive integration plumbing so your team can focus on the workflow instead of the infrastructure. |
| **Agent usability** | You still need to expose the right Todoist actions to the runtime in a format your agent can reliably use. | 8 tools for Todoist are already exposed through ClawLink, so the agent can read and act from chat immediately. |

## ClawLink vs. Composio

Composio also exposes Todoist to AI agents. It is developer infrastructure: Python and TypeScript SDKs, an MCP server, and a catalog past 1,000 apps, aimed at teams shipping agent products. ClawLink is built for Hermes Agent users instead. You install the plugin once, connect Todoist in the browser, and the 8 tools above work from chat. There is no SDK, no config file, and no API key handling. Choosing between them? Read the full [Composio alternatives](https://claw-link.dev/hub/composio-alternatives) comparison.

### Hermes paired but still can't use Todoist
Pairing is a two-step handshake: run `hermes clawlink begin`, approve the link in your browser, then run `hermes clawlink finish`. If you ran finish before approving, or the approval link expired, run `hermes clawlink begin` again to get a fresh link. Confirm the plugin was installed with `--enable`, then verify with `hermes clawlink test`.

### Connection succeeds but no tools appear
Reconnect Todoist from the dashboard, then start a fresh chat if the runtime still has the old tool catalog loaded.

### The Todoist account is connected but the action fails
Check whether the connected account has access to the workspace, inbox, store, or project you are trying to use. Most failures at this stage are permission mismatches, not ClawLink bugs.

### OAuth finished in the browser but the account is still missing
Try reconnecting Todoist and complete the consent flow in the same browser session. Partial OAuth approvals or switching accounts mid-flow can leave the connection incomplete.

### Is there a Hermes Agent Todoist integration?
Yes. ClawLink is the fastest way to connect Hermes to Todoist: link your Todoist account once in the browser and Hermes Agent can call the Todoist API through 8 ready-made tools — no custom code or token handling.

### How do I connect Todoist to Hermes with ClawLink?
Install the plugin with `hermes plugins install ClawLink-HQ/hermes-plugin --enable`, then pair once: run `hermes clawlink begin`, approve the link in your browser, and run `hermes clawlink finish`. Connect Todoist in the dashboard and Hermes can use it from the next message — no config files or API keys to manage.

### How long does it take to connect Todoist to Hermes Agent?
About two minutes. Sign in, click Connect next to Todoist in the dashboard, authenticate, and Hermes Agent can use it from the next chat message.

### Why use ClawLink instead of wiring Todoist up myself?
The alternative to ClawLink is usually manual OAuth app setup plus your own token handling, permission troubleshooting, and tool plumbing for Hermes Agent. That is fine if you want to build and maintain the integration yourself. Most teams just want Todoist working from chat.

### Hermes paired but still can't use Todoist
Pairing is a two-step handshake: run `hermes clawlink begin`, approve the link in your browser, then run `hermes clawlink finish`. If you ran finish before approving, or the approval link expired, run `hermes clawlink begin` again to get a fresh link. Confirm the plugin was installed with `--enable`, then verify with `hermes clawlink test`.

## Related

- [Hermes Typeform integration](https://claw-link.dev/hermes/typeform) — Create interactive forms and surveys
- [DocuSign tools](https://claw-link.dev/hermes/docusign) — Send, sign, and manage agreements and envelopes
- [Motion tools](https://claw-link.dev/hermes/motion) — Manage Motion workspaces, projects, and tasks