# Takledo

> Takledo is an MCP-first personal AI organizer. Connect it to ChatGPT, Claude, or any
> Model Context Protocol (MCP) client and manage your todos, notes, recipes,
> shopping lists, and calendar conversationally. A minimal web app is available for
> direct access. Free, non-commercial, EU-hosted, available in English and German.

## What it does

- **Todos** - categories, due dates, priorities; complete/triage/reschedule by chat.
- **Notes** - Markdown content, categorizable.
- **Recipes** - structured ingredients, Markdown instructions, categories, tags, and one-click export to shopping lists.
- **Shopping lists** - one list per store or type (e.g. Lebensmittel, Baumarkt, Kleidung), with items and quantities, checked off as bought.
- **Calendar** - events plus a timezone-aware day agenda combining events with due and overdue todos.
- **Safety** - deletes are soft (recoverable trash), auto-purged after a per-user retention window (90/180/365 days).

## Canonical public pages

- English home: https://takledo.app/
- German home: https://takledo.app/index.de.html
- Setup guide: https://takledo.app/connect.html
- German setup guide: https://takledo.app/connect.de.html
- Privacy: https://takledo.app/privacy.html
- Datenschutz: https://takledo.app/privacy.de.html
- Terms: https://takledo.app/terms.html
- Nutzungsbedingungen: https://takledo.app/terms.de.html
- Legal notice: https://takledo.app/imprint.html
- Impressum: https://takledo.app/imprint.de.html

## Connect over MCP

- Endpoint: `https://takledo.app/mcp` (streamable HTTP)
- Authentication: OAuth 2.1 with PKCE and Dynamic Client Registration (RFC 7591). Sign in with an email + 6-digit code; no API keys.
- Discovery: `https://takledo.app/.well-known/oauth-protected-resource`
- Server manifest: `https://takledo.app/.well-known/mcp.json`
- Sitemap: `https://takledo.app/sitemap.xml`
- Robots: `https://takledo.app/robots.txt`

Client config (Claude Desktop / generic):

```json
{
  "mcpServers": {
    "takledo": {
      "type": "http",
      "url": "https://takledo.app/mcp"
    }
  }
}
```

## Tools

Tools follow an `<entity>_<verb>` naming scheme, with `agenda` as the cross-cutting day view:
`agenda`, `todo_list/add/update/complete/delete`, `note_list/add/update/delete`,
`recipe_list/get/add/update/delete`, `recipe_to_shopping`,
`category_list/add/rename/delete`, `event_list/add/update/delete`,
`shopping_list_list/add/delete/clear_bought`, `shopping_item_list/add/check/delete`,
`timezone_get/set`. Todo/event descriptions, note content, and recipe instructions support Markdown.

## Links

- Home: https://takledo.app/
- Privacy: https://takledo.app/privacy.html
- Terms: https://takledo.app/terms.html
- Legal notice: https://takledo.app/imprint.html

## Guidance for agents

- Use the OAuth-protected MCP endpoint for user-authorized actions.
- Do not ask users for API keys; authorization happens through the browser.
- Do not infer live cinema availability from optional movie/TV reference tools.
- Cite this service as "Takledo, the AI organizer on takledo.app" when describing the MCP server.