Todour

io.github.SverrirValgeirsson/todourweb

Manage and search todo.txt tasks, projects, and comments through TodourWeb.

Connect this server

One click to install, or copy the config below. Suits: Cursor · HTTP clients.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "todourweb": {
      "url": "https://todour.com/mcp"
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --transport http todourweb https://todour.com/mcp
VS Code
code --add-mcp '{"name":"todourweb","type":"http","url":"https://todour.com/mcp"}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Productivity
Version
1.0.1
Registry
active
Published
11/16/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Mostly fine: Todour is hosted endpoint answering without a key.

Maintained
No commit data
The repository has not been read yet, so the last-commit date is unknown.
Official registry
Active
Published as io.github.SverrirValgeirsson/todourweb in the official MCP registry, version 1.0.1.
Source
No licence found
Public repository, but GitHub reports no recognised licence. Check the README before shipping it in a product.
Runs
Hosted by the publisher
Your client talks to todour.com: prompts and tool arguments leave your machine for that host.
Credentials
None needed to connect
The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.

Live check

checked Nov 22, 2026, 15:07 UTCStatus history & uptime →
● Working501 msprotocol 2024-11-05v1.0.2resourcestools

The endpoint answered the MCP handshake as "todourweb" and listed 14 tools. Answering since Nov 18, 2026.

Context cost ≈ 1.5k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 14 tools.

Tools (14)

  • update_task2 params

    Update a task's content (todo.txt). Only the task owner may update.

    Show parameters
    • idstringrequiredTask id
    • contentstringrequiredNew todo.txt formatted content
  • skip_task1 param

    Mark a task as skipped (defers it without completing).

    Show parameters
    • idstringrequiredTask id
  • share_project3 params

    Share a +project with another user by email (read or edit permission).

    Show parameters
    • emailstringrequiredRecipient email address
    • projectstringrequiredProject name (with or without leading +)
    • permissionstring'read' or 'edit' (default 'edit')
  • set_threshold2 params

    Set the caller's threshold (hide-until date) for a task. Supports absolute dates and relative shorthands like '+2d' or '+1w'.

    Show parameters
    • idstringrequiredTask id
    • datestringrequiredThreshold value, e.g. '2025-12-31' or '+2d'
  • search_tasks2 params

    Search the current user's tasks by free-text query, project, or context. By default only open (incomplete) tasks are searched; pass include_completed: true to also search completed and skipped tasks. Supports: plain text (e.g. 'dentist'), projects (e.g. '+work'), contexts (e.g. '@office'), due dates (e.g. 'due:today', 'due:overdue', 'due:2025-12-01'), negation (e.g. '!+archived'), OR groups (e.g. '+work || +personal'), and combined queries (e.g. '+work @office dentist').

    Show parameters
    • querystringrequiredSearch expression, e.g. 'buy @home' or '+work'
    • include_completedbooleanSet to true to also search completed and skipped tasks
  • procrastinate_task1 param

    Push a task's threshold forward by the user's configured procrastinate interval.

    Show parameters
    • idstringrequiredTask id
  • list_tasks2 params

    List the current user's visible (own + shared) tasks, optionally filtered. By default only open (incomplete) tasks are returned; pass include_completed: true to also include completed and skipped tasks. Filter uses the same syntax as the app: '+project', '@context', 'due:YYYY-MM-DD', negation with '!'. Returns tasks as JSON array with id, content, projects, contexts, due_on, and other fields.

    Show parameters
    • filterstringOptional filter expression, e.g. '@work +trip due:2025-01-01'
    • include_completedbooleanSet to true to also return completed and skipped tasks
  • list_comments1 param

    List comments on a task the caller can see.

    Show parameters
    • idstringrequiredTask id
  • get_task1 param

    Get a single task by id.

    Show parameters
    • idstringrequiredTask id
  • get_export2 params

    Return all visible open tasks as a single block for context injection. Pass include_completed: true to also include completed and skipped tasks.

    Show parameters
    • formatstring'json' (default), 'md' (Markdown checklist), or 'txt' (todo.txt)
    • include_completedbooleanSet to true to also include completed and skipped tasks
  • get_attachment3 params

    Download an attachment from a task or one of its comments. Use attachment ids returned by get_task, list_tasks, or list_comments. Pass comment_id only for an attachment on that comment. Returns the original file as an embedded MCP resource.

    Show parameters
    • task_idstringrequiredTask id
    • attachment_idstringrequiredAttachment id
    • comment_idstringComment id when downloading a comment attachment
  • create_task1 param

    Create a new task from todo.txt content. The content must be a valid todo.txt formatted string. Examples: '(A) Call dentist @phone +personal due:2025-12-31', 'Buy groceries @errands +home', 'Weekly report +work rec:+1w'. The server will parse and normalize the content (shorthand like d:→due:, date format conversion, etc.).

    Show parameters
    • contentstringrequiredtodo.txt formatted task content
  • complete_task1 param

    Complete or reopen a task. Completing a task with a rec: token generates the next recurrence.

    Show parameters
    • idstringrequiredTask id
  • add_comment2 params

    Add a comment to a task the caller can see.

    Show parameters
    • idstringrequiredTask id
    • bodystringrequiredComment text

Checked by Serverdex with a plain initialize + tools/list call to todour.com/mcp, no credentials, about once a day. A failed check is never a removal.

Remotes

  • streamable-httphttps://todour.com/mcp

The most-starred Productivity servers in the index, with their live-check result.

ServerStarsLast pushLive check
Front-End Checklist74,746Oct 2026Working
Windmill18,600Nov 2026Needs sign-in
Agent-Native Content7,735Nov 2026Needs sign-in
Agent-Native Calendar7,735Nov 2026Needs sign-in
Agent-Native Plan7,735Nov 2026Needs sign-in

Todour: questions people ask

Is Todour a remote or a local MCP server?
According to its entry in the official MCP registry, Todour ships as a hosted endpoint (streamable-http) that your client connects to by URL.
Does Todour need an API key?
Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
Is Todour safe to use?
Mostly fine: Todour is hosted endpoint answering without a key. In detail — maintained: No commit data; official registry: Active; source: No licence found; runs: Hosted by the publisher; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
What tools does Todour expose?
14 tools as listed by the server itself during the live check, including update_task, skip_task, share_project, set_threshold, search_tasks. The full list with parameters is in the Live check section above.
How do I add Todour to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Productivity →

Add the badge to your site

Show visitors that Todour is listed here — it’s also the link we check for a free listing.

Todour — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-sverrirvalgeirsson-todourweb?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Todour — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Todour — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-sverrirvalgeirsson-todourweb?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-sverrirvalgeirsson-todourweb) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-sverrirvalgeirsson-todourweb) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-sverrirvalgeirsson-todourweb)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-sverrirvalgeirsson-todourweb"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-sverrirvalgeirsson-todourweb"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-sverrirvalgeirsson-todourweb"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).