How do I use Todocko MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Todocko MCP Server list all high priority tasks in the Website project" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Todocko MCP Server

English version below / Jump to English

MCP (Model Context Protocol) server pro práci s daty Todocko aplikace z AI asistentů.

Podpora

Claude Desktop - plná podpora
Claude Code (CLI) - plná podpora (stejná konfigurace)

Požadavky

Node.js 18+
Todocko účet s daty synchronizovanými přes Evolu

Instalace

1. Stažení

Pomocí git:

git clone https://github.com/brnt-cz/todocko-mcp.git
cd todocko-mcp

Nebo stáhněte ZIP z Releases a rozbalte.

2. Spuštění instalátoru

Linux/macOS:

chmod +x install.sh
./install.sh

Windows (PowerShell):

.\install.ps1

Instalátor:

Nainstaluje závislosti a sestaví projekt
Zeptá se, zda chcete nakonfigurovat Claude Desktop, Claude Code nebo obojí
Vytvoří konfigurační soubor s placeholderem
Ručně doplňte svou 24slovnou zálohovací frázi do konfiguračního souboru
Restartujte Claude

Manuální instalace

Nainstalujte závislosti:
```
npm install
npm run build
```
Přidejte do konfigurace:

Claude Desktop (~/.config/Claude/claude_desktop_config.json na Linuxu nebo ~/Library/Application Support/Claude/claude_desktop_config.json na macOS):

{
  "mcpServers": {
    "todocko": {
      "command": "node",
      "args": ["/cesta/k/mcp-server/dist/index.js"],
      "env": {
        "TODOCKO_MNEMONIC": "vaše 24slovná zálohovací fráze"
      }
    }
  }
}

Claude Code (CLI) - přidejte do ~/.claude/settings.json:

{
  "mcpServers": {
    "todocko": {
      "command": "node",
      "args": ["/cesta/k/mcp-server/dist/index.js"],
      "env": {
        "TODOCKO_MNEMONIC": "vaše 24slovná zálohovací fráze"
      }
    }
  }
}

Restartujte Claude Desktop / Claude Code

Dostupné nástroje (86)

Projekty

Nástroj	Popis
`td_list_projects`	Seznam všech projektů
`td_get_project`	Detail projektu podle ID nebo kódu
`td_create_project`	Vytvoření nového projektu
`td_update_project`	Aktualizace projektu
`td_delete_project`	Smazání projektu (soft delete)

Úkoly

Nástroj	Popis
`td_list_tasks`	Seznam úkolů s filtry (projekt, status, priorita, assignee)
`td_get_task`	Detail úkolu podle ID nebo kódu (např. `PROJ-123`)
`td_create_task`	Vytvoření nového úkolu (včetně recurrence)
`td_update_task`	Aktualizace existujícího úkolu (včetně recurrence)
`td_search_tasks`	Vyhledávání úkolů podle textu
`td_bulk_update_tasks`	Hromadná aktualizace více úkolů
`td_bulk_delete_tasks`	Hromadné smazání více úkolů

Uživatelé

Nástroj	Popis
`td_list_users`	Seznam všech uživatelů
`td_get_user`	Detail uživatele
`td_create_user`	Vytvoření nového uživatele
`td_update_user`	Aktualizace uživatele
`td_delete_user`	Smazání uživatele (soft delete)

Worklogy

Nástroj	Popis
`td_list_worklogs`	Seznam worklogů pro úkol
`td_add_worklog`	Přidání worklogu k úkolu
`td_update_worklog`	Aktualizace worklogu
`td_delete_worklog`	Smazání worklogu (soft delete)

Přílohy

Nástroj	Popis
`td_upload_attachment`	Nahrání přílohy k úkolu (ze souboru nebo base64)
`td_list_attachments`	Seznam příloh úkolu
`td_download_attachment`	Stažení přílohy
`td_delete_attachment`	Smazání přílohy

Komentáře

Nástroj	Popis
`td_list_task_comments`	Seznam komentářů k úkolu
`td_create_task_comment`	Přidání komentáře k úkolu
`td_update_task_comment`	Úprava komentáře
`td_delete_task_comment`	Smazání komentáře (soft delete)

Checklist

Nástroj	Popis
`td_list_checklist_items`	Seznam položek checklistu úkolu
`td_create_checklist_item`	Přidání položky checklistu
`td_update_checklist_item`	Aktualizace položky (zaškrtnutí, pozice)
`td_delete_checklist_item`	Smazání položky (soft delete)

Zmínky (mentions)

Nástroj	Popis
`td_list_mentions`	Seznam zmínek uživatele
`td_create_mention`	Vytvoření zmínky
`td_mark_mention_read`	Označení zmínky jako přečtené
`td_mark_all_mentions_read`	Označení všech zmínek jako přečtených
`td_delete_mention`	Smazání zmínky (soft delete)

Linky mezi úkoly

Nástroj	Popis
`td_list_task_links`	Seznam linků úkolu
`td_create_task_link`	Vytvoření linku mezi úkoly
`td_delete_task_link`	Smazání linku (soft delete)

Tagy

Nástroj	Popis
`td_list_tags`	Seznam všech tagů
`td_create_tag`	Vytvoření nového tagu
`td_delete_tag`	Smazání tagu (soft delete)
`td_list_task_tags`	Seznam tagů přiřazených k úkolu
`td_add_tag_to_task`	Přiřazení tagu k úkolu
`td_remove_tag_from_task`	Odebrání tagu z úkolu

Šablony úkolů

Nástroj	Popis
`td_list_task_templates`	Seznam šablon úkolů
`td_create_task_template`	Vytvoření šablony
`td_update_task_template`	Aktualizace šablony
`td_delete_task_template`	Smazání šablony (soft delete)

Kanban sloupce

Nástroj	Popis
`td_list_kanban_columns`	Seznam kanban sloupců
`td_create_kanban_column`	Vytvoření sloupce
`td_update_kanban_column`	Aktualizace sloupce
`td_delete_kanban_column`	Smazání sloupce (soft delete)

Uložená zobrazení

Nástroj	Popis
`td_list_saved_views`	Seznam uložených zobrazení
`td_create_saved_view`	Vytvoření zobrazení
`td_update_saved_view`	Aktualizace zobrazení
`td_delete_saved_view`	Smazání zobrazení (soft delete)

Aktivita

Nástroj	Popis
`td_list_activity_log`	Seznam zápisů aktivity (read-only)

Poznámky k projektu

Nástroj	Popis
`td_list_project_notes`	Seznam lokálních poznámek projektu
`td_create_project_note`	Vytvoření lokální poznámky
`td_update_project_note`	Aktualizace lokální poznámky
`td_delete_project_note`	Smazání lokální poznámky (soft delete)

Deployment stages

Nástroj	Popis
`td_list_deployment_stages`	Seznam deployment stages pro projekt

Repository linky

Nástroj	Popis
`td_list_repository_links`	Seznam repozitářových linků
`td_create_repository_link`	Vytvoření repozitářového linku
`td_delete_repository_link`	Smazání repozitářového linku

Sdílené projekty

Nástroj	Popis
`td_list_shared_projects`	Seznam sdílených projektů
`td_list_shared_tasks`	Seznam úkolů ze sdíleného projektu
`td_update_shared_task`	Aktualizace úkolu ve sdíleném projektu
`td_list_shared_deployment_stages`	Seznam deployment stages pro sdílený projekt
`td_create_shared_deployment_stage`	Vytvoření deployment stage ve sdíleném projektu
`td_list_shared_repository_links`	Seznam repozitářových linků sdíleného projektu
`td_create_shared_repository_link`	Vytvoření repozitářového linku ve sdíleném projektu
`td_list_shared_project_notes`	Seznam poznámek sdíleného projektu
`td_create_shared_project_note`	Vytvoření poznámky ve sdíleném projektu
`td_update_shared_project_note`	Aktualizace poznámky ve sdíleném projektu
`td_delete_shared_project_note`	Smazání poznámky ve sdíleném projektu

Analytika a přehledy

Nástroj	Popis
`td_get_dashboard_summary`	Přehled: úkoly dnes, po termínu, odpracováno tento týden, nadcházející deadline
`td_get_team_workload`	Vytížení týmu: odpracováno vs odhad vs kapacita per uživatel za období
`td_list_recurring_tasks`	Seznam opakujících se úkolů s konfigurací opakování
`td_list_overdue_tasks`	Úkoly po termínu (seřazené od nejstaršího)
`td_list_tasks_by_date_range`	Úkoly filtrované podle scheduledDate nebo deadline v daném rozmezí
`td_analyze_dependencies`	Analýza závislostí: blokované úkoly, blokující řetězce, kritická cesta

Diagnostika

Nástroj	Popis
`td_sync_status`	Stav synchronizace

Příklady použití

Seznam projektů

Zobraz mi seznam všech projektů v Todocko

Seznam úkolů

Jaké mám úkoly ve stavu "todo"?
Zobraz úkoly projektu TODO

Detail úkolu

Jaké jsou detaily úkolu TODO-15?

Vytvoření úkolu

Vytvoř nový úkol v projektu PROJ s názvem "Opravit bug v přihlášení" a prioritou high
Vytvoř úkol s deadline na 2026-03-15 a scheduledDate na 2026-03-10

Aktualizace úkolu

Označ úkol PROJ-5 jako dokončený
Přiřaď úkol TODO-10 uživateli s ID xyz
Nastav scheduledDate úkolu TODO-10 na zítra

Logování času

Zaloguj 2 hodiny práce na úkol TODO-15 s popisem "Implementace feature"

Práce s přílohami

Nahraj soubor /home/user/report.pdf jako přílohu k úkolu TODO-15
Jaké přílohy má úkol TODO-15?
Smaž přílohu s ID xyz

Sdílené projekty

Zobraz sdílené projekty
Jaké úkoly jsou ve sdíleném projektu?
Označ úkol jako nasazený na produkci

Deployment stages

Jaké deployment stages má projekt?
Vytvoř novou deployment stage "Staging" pro sdílený projekt

Přehledy a analytika

Jaký mám dnes přehled? (dashboard summary)
Jak je vytížený tým tento týden?
Jaké úkoly jsou po termínu?
Zobraz úkoly naplánované na příští týden
Analyzuj závislosti v projektu TODO
Jaké mám opakující se úkoly?

Bezpečnost

Důležité: Vaše zálohovací fráze (mnemonic) je citlivý údaj!

Nikdy ji nesdílejte v přímé konverzaci s AI
V konfiguraci MCP serveru je fráze bezpečná (AI k ní nemá přístup)
Kdokoli s vaší frází má plný přístup k vašim datům

Umístění dat

Databáze jsou uloženy v adresáři ~/.todocko/:

Platforma	Cesta
Linux	`~/.todocko/`
macOS	`~/.todocko/`
Windows	`C:\Users\<user>\.todocko\`

Soubory:

todocko.db - vaše osobní data (úkoly, projekty)
todocko-shared.db - sdílené projekty

Změna konfigurace

Claude Code (CLI)

Po změně konfigurace v ~/.claude/settings.json (např. změna mnemonicu) spusťte příkaz:

/mcp

Tím se MCP server restartuje s novou konfigurací.

Přepnutí na jiný účet

Při změně mnemonicu na jiný Todocko účet je potřeba smazat lokální databázi:

# Linux/macOS
rm ~/.todocko/todocko.db

# Windows
del %USERPROFILE%\.todocko\todocko.db

Databáze obsahuje ID vlastníka z předchozího mnemonicu. Po smazání se při dalším spuštění vytvoří nová databáze a stáhnou se data nového účtu.

Troubleshooting

Server se nespustí

Zkontrolujte, že máte Node.js 18+
Zkontrolujte, že jste spustili npm run build
Zkontrolujte logy v Claude Desktop

Data se nesynchronizují

Ověřte, že je zálohovací fráze správná (24 slov)
Zkontrolujte internetové připojení
Počkejte pár sekund na synchronizaci
Zkuste smazat ~/.todocko/todocko.db a restartovat

Nástroje nejsou viditelné

Restartujte Claude Desktop
V Claude Code použijte /mcp pro reload
Zkontrolujte konfigurační soubor
Zkontrolujte cestu k dist/index.js

Vývoj

# Instalace závislostí
npm install

# Build
npm run build

# Watch mode pro vývoj
npm run dev

# Ruční spuštění
TODOCKO_MNEMONIC="vaše fráze" npm start

English

MCP (Model Context Protocol) server for working with Todocko app data from AI assistants.

Support

Claude Desktop - full support
Claude Code (CLI) - full support (same configuration)

Requirements

Node.js 18+
Todocko account with data synchronized via Evolu

Installation

1. Download

Using git:

git clone https://github.com/brnt-cz/todocko-mcp.git
cd todocko-mcp

Or download ZIP from Releases and extract.

2. Run the installer

Linux/macOS:

chmod +x install.sh
./install.sh

Windows (PowerShell):

.\install.ps1

The installer will:

Install dependencies and build the project
Ask whether to configure Claude Desktop, Claude Code, or both
Create a configuration file with a placeholder
Manually add your 24-word backup phrase to the configuration file
Restart Claude

Manual installation

Install dependencies:
```
npm install
npm run build
```
Add to configuration:

Claude Desktop (~/.config/Claude/claude_desktop_config.json on Linux or ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "todocko": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"],
      "env": {
        "TODOCKO_MNEMONIC": "your 24 word backup phrase"
      }
    }
  }
}

Claude Code (CLI) - add to ~/.claude/settings.json:

{
  "mcpServers": {
    "todocko": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"],
      "env": {
        "TODOCKO_MNEMONIC": "your 24 word backup phrase"
      }
    }
  }
}

Restart Claude Desktop / Claude Code

Available Tools (86)

Projects

Tool	Description
`td_list_projects`	List all projects
`td_get_project`	Get project details by ID or code
`td_create_project`	Create a new project
`td_update_project`	Update a project
`td_delete_project`	Delete a project (soft delete)

Tasks

Tool	Description
`td_list_tasks`	List tasks with filters (project, status, priority, assignee)
`td_get_task`	Get task details by ID or code (e.g., `PROJ-123`)
`td_create_task`	Create a new task (with recurrence support)
`td_update_task`	Update an existing task (with recurrence support)
`td_search_tasks`	Search tasks by text
`td_bulk_update_tasks`	Bulk update multiple tasks
`td_bulk_delete_tasks`	Bulk delete multiple tasks

Users

Tool	Description
`td_list_users`	List all users
`td_get_user`	Get user details
`td_create_user`	Create a new user
`td_update_user`	Update a user
`td_delete_user`	Delete a user (soft delete)

Worklogs

Tool	Description
`td_list_worklogs`	List worklogs for a task
`td_add_worklog`	Add a worklog to a task
`td_update_worklog`	Update a worklog
`td_delete_worklog`	Delete a worklog (soft delete)

Attachments

Tool	Description
`td_upload_attachment`	Upload an attachment to a task (from file or base64)
`td_list_attachments`	List attachments for a task
`td_download_attachment`	Download an attachment
`td_delete_attachment`	Delete an attachment

Comments

Tool	Description
`td_list_task_comments`	List comments for a task
`td_create_task_comment`	Add a comment to a task
`td_update_task_comment`	Update a comment
`td_delete_task_comment`	Delete a comment (soft delete)

Checklist

Tool	Description
`td_list_checklist_items`	List checklist items for a task
`td_create_checklist_item`	Add a checklist item
`td_update_checklist_item`	Update a checklist item (check, reposition)
`td_delete_checklist_item`	Delete a checklist item (soft delete)

Mentions

Tool	Description
`td_list_mentions`	List mentions for a user
`td_create_mention`	Create a mention
`td_mark_mention_read`	Mark a mention as read
`td_mark_all_mentions_read`	Mark all mentions as read
`td_delete_mention`	Delete a mention (soft delete)

Task Links

Tool	Description
`td_list_task_links`	List links for a task
`td_create_task_link`	Create a link between tasks
`td_delete_task_link`	Delete a task link (soft delete)

Task Templates

Tool	Description
`td_list_task_templates`	List task templates
`td_create_task_template`	Create a task template
`td_update_task_template`	Update a task template
`td_delete_task_template`	Delete a task template (soft delete)

Kanban Columns

Tool	Description
`td_list_kanban_columns`	List kanban columns
`td_create_kanban_column`	Create a kanban column
`td_update_kanban_column`	Update a kanban column
`td_delete_kanban_column`	Delete a kanban column (soft delete)

Saved Views

Tool	Description
`td_list_saved_views`	List saved views
`td_create_saved_view`	Create a saved view
`td_update_saved_view`	Update a saved view
`td_delete_saved_view`	Delete a saved view (soft delete)

Activity Log

Tool	Description
`td_list_activity_log`	List activity log entries (read-only)

Project Notes

Tool	Description
`td_list_project_notes`	List local project notes
`td_create_project_note`	Create a local project note
`td_update_project_note`	Update a local project note
`td_delete_project_note`	Delete a local project note (soft delete)

Deployment Stages

Tool	Description
`td_list_deployment_stages`	List deployment stages for a project

Repository Links

Tool	Description
`td_list_repository_links`	List repository links
`td_create_repository_link`	Create a repository link
`td_delete_repository_link`	Delete a repository link

Shared Projects

Tool	Description
`td_list_shared_projects`	List shared projects
`td_list_shared_tasks`	List tasks from a shared project
`td_update_shared_task`	Update a task in a shared project
`td_list_shared_deployment_stages`	List deployment stages for a shared project
`td_create_shared_deployment_stage`	Create a deployment stage in a shared project
`td_list_shared_repository_links`	List repository links for a shared project
`td_create_shared_repository_link`	Create a repository link in a shared project
`td_list_shared_project_notes`	List notes for a shared project
`td_create_shared_project_note`	Create a note in a shared project
`td_update_shared_project_note`	Update a note in a shared project
`td_delete_shared_project_note`	Delete a note in a shared project

Analytics & Reports

Tool	Description
`td_get_dashboard_summary`	Overview: tasks today, overdue, this week's worklog, upcoming deadlines
`td_get_team_workload`	Team workload: logged vs estimate vs capacity per user for a period
`td_list_recurring_tasks`	List recurring tasks with recurrence configuration
`td_list_overdue_tasks`	Overdue tasks (sorted oldest first)
`td_list_tasks_by_date_range`	Tasks filtered by scheduledDate or deadline within a date range
`td_analyze_dependencies`	Dependency analysis: blocked tasks, blocking chains, critical path

Diagnostics

Tool	Description
`td_sync_status`	Sync status

Usage Examples

List projects

Show me all projects in Todocko

List tasks

What tasks do I have with status "todo"?
Show tasks for project TODO

Task details

What are the details of task TODO-15?

Create task

Create a new task in project PROJ with title "Fix login bug" and priority high
Create a task with deadline 2026-03-15 and scheduledDate 2026-03-10

Update task

Mark task PROJ-5 as completed
Assign task TODO-10 to user with ID xyz
Set scheduledDate of task TODO-10 to tomorrow

Log time

Log 2 hours of work on task TODO-15 with description "Feature implementation"

Working with attachments

Upload file /home/user/report.pdf as attachment to task TODO-15
What attachments does task TODO-15 have?
Delete attachment with ID xyz

Shared projects

Show shared projects
What tasks are in the shared project?
Mark task as deployed to production

Deployment stages

What deployment stages does the project have?
Create a new deployment stage "Staging" for the shared project

Analytics & Reports

What's my dashboard summary for today?
How is the team's workload this week?
What tasks are overdue?
Show tasks scheduled for next week
Analyze dependencies in project TODO
What recurring tasks do I have?

Security

Important: Your backup phrase (mnemonic) is sensitive data!

Never share it directly in conversation with AI
In the MCP server configuration, the phrase is safe (AI has no access to it)
Anyone with your phrase has full access to your data

Data Location

Databases are stored in the ~/.todocko/ directory:

Platform	Path
Linux	`~/.todocko/`
macOS	`~/.todocko/`
Windows	`C:\Users\<user>\.todocko\`

Files:

todocko.db - your personal data (tasks, projects)
todocko-shared.db - shared projects

Configuration Changes

Claude Code (CLI)

After changing configuration in ~/.claude/settings.json (e.g., changing mnemonic), run the command:

/mcp

This will restart the MCP server with the new configuration.

Switching to a Different Account

When changing the mnemonic to a different Todocko account, you need to delete the local database:

# Linux/macOS
rm ~/.todocko/todocko.db

# Windows
del %USERPROFILE%\.todocko\todocko.db

The database contains the owner ID from the previous mnemonic. After deletion, a new database will be created on the next startup and data from the new account will be downloaded.

Troubleshooting

Server won't start

Check that you have Node.js 18+
Check that you ran npm run build
Check logs in Claude Desktop

Data not syncing

Verify the backup phrase is correct (24 words)
Check internet connection
Wait a few seconds for synchronization
Try deleting ~/.todocko/todocko.db and restart

Tools not visible

Restart Claude Desktop
In Claude Code, use /mcp for reload
Check the configuration file
Check the path to dist/index.js

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode for development
npm run dev

# Manual run
TODOCKO_MNEMONIC="your phrase" npm start

Todocko MCP Server

Podpora

Požadavky

Instalace

1. Stažení

2. Spuštění instalátoru

Manuální instalace

Dostupné nástroje (86)

Projekty

Úkoly

Uživatelé

Worklogy

Přílohy

Komentáře

Checklist

Zmínky (mentions)

Linky mezi úkoly

Tagy

Šablony úkolů

Kanban sloupce

Uložená zobrazení

Aktivita

Poznámky k projektu

Deployment stages

Repository linky

Sdílené projekty

Analytika a přehledy

Diagnostika

Příklady použití

Seznam projektů

Seznam úkolů

Detail úkolu

Vytvoření úkolu

Aktualizace úkolu

Logování času

Práce s přílohami

Sdílené projekty

Deployment stages

Přehledy a analytika

Bezpečnost

Umístění dat

Změna konfigurace

Claude Code (CLI)

Přepnutí na jiný účet

Troubleshooting

Server se nespustí

Data se nesynchronizují

Nástroje nejsou viditelné

Vývoj

English

Support

Requirements

Installation

1. Download

2. Run the installer

Manual installation

Available Tools (86)

Projects

Tasks

Users

Worklogs

Attachments

Comments

Checklist

Mentions

Task Links

Tags

Task Templates

Kanban Columns

Saved Views

Activity Log

Project Notes

Deployment Stages

Repository Links

Shared Projects

Analytics & Reports

Diagnostics

Usage Examples

List projects

List tasks