Todoist Setup

What it does

When your agent uses it

• The user says I use Todoist
• Pastes a todoist.com link

Example prompts

• “I use Todoist”
• “sync Todoist”
• “/todoist-setup”

Requirements

• Python 3
• A credential in TODOIST_API_KEY

Workflow steps

8 steps, taken from the step headings in SKILL.md.

1. 1Check if Already Connected
2. 2Explain What We're Setting Up
3. 3Enter the API Key Locally
4. 4Store the Local Credential
5. 5Test the Connection
6. 6Choose Default Project
7. 7Save Configuration
8. 8Capability Cascade

What it can do on your machine

Read from SKILL.md and the folder at commit 227f78e. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • python3

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • TODOIST_API_KEY

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Todoist Setup loads about 2.2k tokens when it runs. Until then it costs about 68 tokens; SKILL.md has 723 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~68

When it runs · the whole SKILL.md, loaded when a task matches

~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NoteMentions a .env fileSKILL.md:41

  y stays local in the ignored vault-root `.env` file. Tracked YAML stores only its variable name.

• NoteMentions a .env fileSKILL.md:94

  nversation. Open the ignored vault-root `.env` in your

• NoteMentions a .env fileSKILL.md:108

  Confirm locally that `.env` defines `TODOIST_API_KEY` without printing or returning its value.

• NoteMentions a .env fileSKILL.md:110

  ore continuing if it reports an invalid `.env` authority.

• NoteMentions a .env fileSKILL.md:120

  tdin read-only health path. It resolves `.env`

• NoteMentions a .env fileSKILL.md:229

  odoist-setup` to restore the vault-root `.env` value and tracked reference.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from davekilleen/Dex at commit 227f78e, republished under its MIT licence (© davekilleen). 723 words, ~2,156 tokens.

name

todoist-setup

description

Connect Todoist so Dex reads and updates your Todoist tasks two ways. Use when the user says 'I use Todoist', 'sync Todoist', or pastes a todoist.com link. Not for Things 3 (`things-setup`) or Trello (`trello-setup`); not for Jira tickets (`atlassian-setup`).

integration.id

todoist

integration.name

Todoist

integration.auth

api_key

<!-- Generated from `.claude/skills/todoist-setup/SKILL.md` by `scripts/generate-agents-skills.py`. Do not edit. -->

**Let's connect Todoist to Dex.**

Once connected, you can ask me to check, create, or complete Todoist tasks
right from our conversations.

**What you'll need:**
- Your Todoist API token (I'll show you where to find it)
- About 2 minutes

**Ready to go?**

To get your Todoist API token:

1. Open Todoist (web or app)
2. Go to **Settings** → **Integrations** → **Developer**
3. Copy the **API token** shown there

Do not paste the token into this conversation. Open the ignored vault-root `.env` in your
local editor and replace the placeholder in this line directly:

`TODOIST_API_KEY=<paste token locally here>`

Save the file with mode `0600`, then reply only `saved`. Dex must never echo, read aloud,
log, or include the value in a command, argv, or process environment.

python3 -c 'from core.integrations.task_sync import check_service_health; print(check_service_health("todoist"))'

Connected! Todoist authentication succeeded through the read-only health check.

That API key didn't work. A few things to check:

1. **Copy the full key** — it should be about 40 characters
2. **Check for extra spaces** before or after the key
3. **Regenerate the key** in Todoist Settings → Integrations → Developer

Want to try again?

**Which Todoist project should Dex tasks go into?**

The health check does not enumerate projects. Open Todoist locally and enter the exact project
name you want Dex to use without pasting any credential.

You can pick one default project, or map each Dex pillar to a different project.

**Option A:** All Dex tasks go to one project (simplest)
**Option B:** Map each pillar to a project:
  (Read pillar names from `System/pillars.yaml` and list them here)
  - [pillar 1 name] → [project]
  - [pillar 2 name] → [project]
  - [pillar 3 name] → [project]

Which works for you?

todoist:
  enabled: true
  configured_at: YYYY-MM-DD
  auth_type: api_key
  api_key_env_var: TODOIST_API_KEY
  project: <default project name>
  pillar_map:
    [pillar_id]: <Todoist project name>   # one entry per pillar, from pillars.yaml

**Todoist is connected!** Here's what you can do now:

- **Ask about Todoist anytime** — "What's due in Todoist today?", "Add that to
  Todoist", "Mark the invoice task done in Todoist".
- **Bring it into your planning** — during `/daily-plan` or `/triage`, ask Dex to
  include or route to Todoist and it will.
- **Sync on demand** — say "sync Dex with Todoist" and new tasks push, completions flow
  both directions, and tasks you added in Todoist come in for review

**Sync is on demand** — say "sync with Todoist" anytime. Dex doesn't poll in the background.

© davekilleen, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/todoist-setup of davekilleen/Dex.

Open the folder on GitHubat commit 227f78e