# Todoist task archive

> Connect Todoist to MMW, preserve available tasks and history, browse the encrypted archive, and export JSON.

MMW can **preserve accessible Todoist data in an independent archive** so your records remain available after you disconnect the integration. This is for long-term retention and retrieval; it is not a replacement task manager.

## What works today

- One-time connection through official Todoist OAuth with **read-only** `data:read` permission.
- Initial import of available projects, tasks, comments, and other Todoist structures.
- Automatic reconciliation approximately **every 10 minutes**, plus manual sync.
- Separate collection of available activity entries and completed tasks; older completion periods are fetched gradually.
- Encrypted storage of original Todoist responses and observed object versions in your personal MMW space.
- Archive browsing, text search, record-type filters, pagination, and JSON export.
- Disconnecting without automatically erasing previously saved records.

Todoist remains a **separate private archive**. Records are not automatically mixed into shared MMW searches. However, connected AI clients can now retrieve them **explicitly** using the MMW `search` tool with a `todoist:` prefix, such as `todoist: project notes`. Compatible MCP clients can also call `search_todoist`. Results contain source identifiers and hashes, but they are not saved as ordinary MMW memories.

## Connect Todoist

1. Sign in to your [MMW account](https://app.mmwhub.tech/?tab=integrations). Open **Integrations** and locate the **Todoist** card.

2. Select **Connect Todoist**. MMW sends you to Todoist's official authorization page.

3. Sign in to Todoist if prompted, then approve **read access**. Do not share your Todoist password or API token with MMW support.

4. Return to MMW. The card should show **Connected**. Available records will be imported and periodically reconciled. You may select **Sync now** to start another read-only sync.

The integration is bound to your **personal MMW space**. It does not automatically populate an organization workspace.

## Search saved tasks

1. In your MMW account, open **Integrations → Todoist → Browse archive**.
2. Enter part of a task title, project name, or other text contained in the original record.
3. Optionally filter by tasks, projects, comments, activity events, or completed tasks.
4. Select **Show original record** to inspect the source data. Use **Previous** and **Next** to browse pages.

Search runs within your own MMW archive. A single query currently scans up to the first **10,000 archived versions**. This is text-based search, not semantic AI-agent retrieval. Use words from the original records for best results.

## Search Todoist from ChatGPT, Claude, and other AI clients

In a connected MMW client, call `search` with an explicit `todoist:` prefix, for example `todoist: project notes`. Clients that discover the extended MCP tool set can call `search_todoist(query="project notes")` directly.

Retrieval is limited to **your own personal Todoist archive**; results are not written into shared MMW memory. Ordinary queries without `todoist:` continue to search ordinary MMW memories only.

## Ask MMW from inside Todoist — upcoming

MMW is developing a dedicated **Todoist UI Extension** to search your ordinary MMW memory from a task or project. The planned flow is: open a Todoist task menu → **Search MMW** → enter a query → see up to five matching memory records without leaving Todoist. Access is limited to the owner of the connected MMW account.

The signed server-side endpoint is implemented, but the UI Extension has **not yet been registered or installed** through Todoist's App Management Console. The Search MMW action is therefore not currently visible in Todoist. Search is available through the MMW cabinet and existing AI clients in the meantime.

According to Todoist's documentation, UI Extensions currently work on **web and desktop**, not mobile. This lookup is read-only and does not require permission to edit Todoist tasks.

## Archive health and observed version history

Open **Integrations → Todoist** in your MMW account and select **Verify archive**. MMW displays the number of stored versions and distinct objects, sync freshness, integrity results and available historical backfill information.

The **integrity check** decrypts and compares hashes for up to the **250 most recently archived versions**. If your archive is larger, the report explicitly indicates that only a sample was checked. A successful check confirms the checked copies can be decrypted and their hashes match; it cannot guarantee Todoist supplied every historical record.

To review changes to a specific task or project, open **Browse archive** and choose **Version history** on a record. You can view observed versions by timestamp and fields that changed between adjacent snapshots. This represents **states MMW actually saved**, not a complete log of everything that happened inside Todoist.

## Export your archive

Choose **Export JSON** in the Todoist card. The browser downloads `mmw-todoist-archive.json` with the saved records, source details, and ingestion times.

The export fixes an upper timestamp before downloading pages. The JSON file includes `schema_version: 2` and `as_of`. The cabinet checks the expected record count and detects duplicates across pages. This reduces the risk of pagination inconsistency while synchronization continues, but it does not replace full-system backups.

**Verify your download offline:** use the [open-source JSON verifier](https://github.com/msingatullin/mmw/blob/main/tools/verify_todoist_export.py) with `python3 verify_todoist_export.py mmw-todoist-archive.json`. It checks per-record SHA-256 hashes, record count, duplicates, and timestamp bounds. It validates the **internal integrity of the file, not the authenticity or completeness of Todoist's historical data**.

The export processes pages and is currently limited to **50,000 items per operation**. If the archive is larger or the process is interrupted, an error is shown and your existing MMW records are not modified.

The downloaded JSON can contain personal data. Store it securely. Unlike the encrypted server-side archive, this exported file contains readable source records.

## Coverage and provider limits

| Data | Current behaviour |
|---|---|
| Projects, tasks, comments | MMW preserves what the official Todoist API actually returns. |
| Completed tasks | Fetched via separate endpoints and historical date windows. Older periods are processed progressively. |
| Activity log | Availability and retention vary by Todoist plan. On some accounts, only the last **7 days** are accessible. |
| Previously deleted data | Data no longer provided by Todoist and never archived by MMW cannot be reconstructed. |
| Change history | MMW keeps versions observed during synchronization. It **cannot guarantee capturing every intermediate change** between polls. |

Currently MMW polls Todoist periodically; Webhook ingestion is not enabled. A short-lived change between polls might therefore be missed. Checking an older completion window does not mean it necessarily contained completed tasks.

## Disconnect or request deletion

- **Disconnect:** choose **Disconnect** in the Todoist card. Further synchronization stops, while the encrypted archive stays in MMW.
- **Delete the archive:** select **Delete MMW archive** on the Todoist card. MMW shows a warning and the number of stored versions, then issues a single-use, 5-minute challenge. To proceed, explicitly type `DELETE TODOIST ARCHIVE` and confirm. This removes saved versions, raw API responses, sync history and the Todoist credential from the **active MMW database**. Previously created backups follow a separate retention schedule and are not instantly erased. Tasks in Todoist are unaffected. For backup-retention questions, contact [support](mailto:support@mmwhub.tech). The MMW `forget` tool applies to ordinary memory, not this archive.
- **Reconnect:** you may reconnect the **same Todoist account**. To prevent mixing two people's records, MMW rejects a different Todoist account when an archive already exists for that connection.

See [Data and deletion](/account/data-and-deletion/) for the broader MMW retention policy.

## Security and limitations

- MMW requests only `data:read` and cannot create, edit, or delete Todoist tasks through this connection.
- Provider credentials and archived contents are encrypted on the MMW server.
- Reading the archive requires MMW authentication and is limited to your personal space.
- If Todoist is unavailable or rate limits apply, the next update may be delayed. Already archived records remain available.

**Technical reference:** [Todoist API v1](https://developer.todoist.com/api/v1/). Feature status reflects November 15, 2026.

## Next steps
