Create an account at sign up and sign in at sign in. Use email and password, or continue with Google when that option is shown. If email verification is on, open the link we send before signing in.

After signing in, Kanso opens at Todos. Add a todo at the top of the list and press Enter; open a todo to change its due date, priority, notes, tags, list or project, subtasks and repeat rule. The sidebar is where you create lists, projects, tags and saved views.

Kanso is local-first: a change applies on your device immediately, then syncs in the background. The sync indicator in the app shows when changes are still uploading.

Notes is a Markdown editor with nested folders, search and Trash. Create a note with New note, or a folder with New folder in the notes sidebar. Drag notes and folders to move them.

To protect notes, set a notes PIN from the sidebar. A locked note is encrypted on your device and asks for the PIN before it opens. If you forget the PIN, the only reset deletes every locked note, so keep the PIN somewhere safe.

The calendar is the Planner (/calendar redirects there). Add events and time blocks, drag todos into time blocks, and check them off without leaving the planner.

To show Google Calendar events, connect Google Calendar in Settings → Connections, then choose the calendars that should appear. The planner can hide or show each connected calendar.

Everything the app can do is also a REST method and an MCP tool. The full reference is at /api/docs; the OpenAPI spec is /api/openapi.json and the agent discovery file is /llms.txt.

Create a key

Open Settings → API or Settings → MCP and create an API key. Treat the key like a password: it can read and change your data. Revoke a key you no longer use.

Connect an MCP client

The MCP URL is /api/mcp. Claude Code, Claude Desktop, Cursor and Codex all accept the URL plus an Authorization: Bearer header. Settings → MCP has copyable snippets for each client. Restart the client after changing its MCP config.

For ChatGPT, add a connector in Settings → Apps & Connectors with the same MCP URL and choose OAuth. The Kanso consent page asks for an API key, then the connector can call the tools your key allows.

REST

Call methods with POST /api/v1/<method> and the arguments as the JSON body, for example POST /api/v1/todos.mine with {}. Use the same bearer key. The API tab has a connection test and curl/CLI examples.

I cannot sign in

Use the same sign-in method you created the account with. If you forgot the password, request a reset from forgot password. If the verification link expired, email support from the address on the account. A verification error asks you to verify before the app opens.

My changes are not syncing

Changes are saved on the device first, so you can keep working while offline. Check the sync indicator and your connection; Kanso retries automatically. Leave the app open until the indicator is clear instead of clearing site data or signing out, which can discard changes that have not uploaded yet.

MCP will not connect

Check that the URL ends in /api/mcp and that the key is sent as Authorization: Bearer <key> (not as a query parameter). Create a fresh key if the old one was revoked, and make sure the client was restarted after the config change. OAuth clients must finish the consent page, including the API key step.

Paid plans are bought through Polar checkout. Choose a plan on the pricing page, create an account or sign in, and finish the Polar checkout. Current prices and plan limits are listed there.

Upgrade or change payment

Open Settings → Billing and choose the plan or Manage Billing. The Polar customer portal handles payment methods, invoices and plan changes.

Cancel

Cancelling also happens in the Polar customer portal from Settings → Billing. You keep Pro until the end of the period you paid for, then the account returns to Free. Your todos, notes and other data stay in the account.

Pro is not active after paying

First open Settings → Billing and refresh the billing status; Polar confirms the payment in the background, which can take a moment. Make sure you paid while signed in to the account you are checking. If it is still not active, email support with your Kanso account email and the Polar order or receipt ID. Never send card numbers.

Email [email protected] with the account email you use for Kanso. For billing, include the Polar order or receipt ID. For sync or MCP problems, include the device, client and the exact error message.