# Mindwtr

Mindwtr is a task manager built around Getting Things Done. Catch every task and idea in one inbox, sort them into projects and next actions, and keep on top of it all with guided daily and weekly reviews.

Use it in your browser, or in Mindwtr's desktop and phone apps. Your ElfHosted Mindwtr includes the sync server, so every device stays on the same list.

**What's in it?**

- **An inbox** for anything on your mind, captured in a couple of keystrokes.
- **Projects, areas and next actions**, with contexts and tags to find the right task for where you are.
- **Guided reviews** that walk you through your lists daily and weekly.
- **Desktop and phone apps** that sync with your ElfHosted Mindwtr.
- **An AI helper** for breaking down and tidying up tasks, using ElfHosted's included AI, so there's no key to find.

[Get a 7-day trial of Mindwtr on ElfHosted Flex! 🪄](<https://store.elfhosted.com/product-category/flex/>)

## How do I access Mindwtr?

Mindwtr is available:

- From your dashboard: [https://your-username.elfhosted.com](<https://your-username.elfhosted.com>)
- Directly: [https://your-username-mindwtr.elfhosted.com](<https://your-username-mindwtr.elfhosted.com>)

> [!NOTE]
>
> **Signed-in users see their own URLs**
>
> The addresses above show the general pattern. [Sign in](<https://docs-internal.elfhosted.com/app/mindwtr/>) and these become your personal, clickable links.

## How do I use it?

### Two addresses, one Mindwtr

- **In your browser**, open Mindwtr from your dashboard. It sits behind your ElfHosted sign-in.
- **Desktop and phone apps** sync with your Mindwtr at [https://your-username-mindwtr.elfhosted.com](<https://your-username-mindwtr.elfhosted.com>) using a **sync token** you choose. They don't use your ElfHosted sign-in.

### Choose your sync token

Sync stays off until you set a sync token. Make up a long random one (20 to 512 letters, numbers or `. _ ~ + / = -`) and keep it somewhere safe, like your password manager. Set it using [ElfBot](<https://docs-internal.elfhosted.com/app/elfbot/>), or ask Sam to do it for you: you type the token on the approval page, so Sam never sees it.

Quick-paste into Mindwtr's environment variables using ElfBot

```
MINDWTR_CLOUD_AUTH_TOKENS=<your long random token>
```

`MINDWTR_CLOUD_AUTH_TOKENS` holds the sync tokens you choose, comma-separated, one per person. Each token gets its own private task list. To give someone else in the household their own list, add their token after yours. Devices that share a list use the same token.

Mindwtr restarts by itself when you save the setting.

### Sync your browser and devices

1. Open **Settings**, then **Sync**, and pick **Self-Hosted**.
2. The address is already filled in on the web. In the desktop and phone apps, enter [https://your-username-mindwtr.elfhosted.com](<https://your-username-mindwtr.elfhosted.com>).
3. Enter your sync token and save.

### Switch on the AI helper

1. In the browser, open **Settings**, then **AI assistant**, and switch on **Enable AI assistant**.
2. Set **Provider** to **OpenAI**.
3. Set **Custom OpenAI-compatible base URL** to [https://your-username-mindwtr.elfhosted.com/bree/v1](<https://your-username-mindwtr.elfhosted.com/bree/v1>) and leave **API key** empty.

There's no save button: Mindwtr saves each setting as you type. Leave the model as it is. ElfHosted's included AI picks the model itself, whatever the box says.

To try it, open a task and use **AI clarify** or **AI breakdown**. The AI helper runs on your plan's included AI allowance. It works in the browser only: the desktop and phone apps would need a key of your own.

### Use it with your AI assistant (MCP)

Mindwtr's own MCP helper can connect an AI assistant to your tasks. Run it on your computer in its Cloud mode, pointed at [https://your-username-mindwtr.elfhosted.com](<https://your-username-mindwtr.elfhosted.com>) with your sync token, and your assistant sees the same list as your devices. It's read-only unless you start it with `--write`. Mindwtr's desktop app also has an MCP server built in. See Mindwtr's [MCP guide](<https://github.com/dongdongbh/Mindwtr/tree/main/apps/mcp-server>) for the setup.

## Mindwtr also works with

- [x] [OpenTodo](</app/opentodo/>)
- [x] [Vikunja](</app/vikunja/>)

## How do I get support for Mindwtr?

1. For general use of Mindwtr, refer to the [official site](<https://github.com/dongdongbh/Mindwtr>) or to one of the links in the resources section below.
2. For specific support re your ElfHosted configuration / account, see the [ElfHosted support options](</get-help/>)!

## Sponsor Mindwtr ❤️

You can contribute directly to the development of Mindwtr using the following:

- [GitHub Sponsors](<https://github.com/sponsors/dongdongbh>)
- [Ko-fi](<https://ko-fi.com/D1D01T20WK>)

## Mindwtr resources

- [Mindwtr (*official site*)](<https://github.com/dongdongbh/Mindwtr>)
- [Mindwtr Website](<https://mindwtr.app>)
- [Mindwtr Docs](<https://docs.mindwtr.app/>)
- [Mindwtr Discord](<https://discord.gg/gc4h5t58PR>)
