Frequently Asked Questions
Everything you need to know about Dovilo.
What is Dovilo?
Dovilo is a gamified productivity app that combines a to-do list, focus sessions with full-screen ambience, and an isometric city builder. Complete your tasks and focus sessions to earn bricks, then use those bricks to build houses, offices, parks, and more in your own virtual city.
Is Dovilo free?
Yes! Dovilo is free to download and use. The free tier includes full to-do management, unlimited tasks and categories, unlimited focus sessions (single and Pomodoro), basic city building, dark & light themes, and zero ads. Dovilo Pro unlocks additional features like cloud sync, the desktop app with its AI task list for coding agents, the Focus Ambience Pack, all buildings and advanced statistics.
What platforms is Dovilo available on?
Dovilo is available on iOS (iPhone & iPad) via the App Store, on Android via Google Play, and as a desktop app for Windows and Mac. The desktop app requires an active Pro subscription. It carries two task surfaces — full to-do management for your own list and AI task management for your agents — plus the MCP server and webhooks that mobile does not have. Focus sessions and the city are mobile features.
What languages are supported?
Dovilo is available in 5 languages: English, Turkish (Türkçe), Spanish (Español), French (Français), and German (Deutsch). The language is detected automatically from your device settings, and you can change it manually in the app.
How does the to-do list work?
You can create tasks with due dates, repeats, reminders, stars, flags, and your own lists. Everything sits behind one view picker: My Day, Important, Planned, Flagged, all Tasks, and each list you keep — every entry showing a live count. Lists group themselves by date (Today, Tomorrow, No date) and each task opens into a detail sheet with its properties and notes. Completing a task earns bricks you can spend in the city builder.
How do focus sessions work?
There are three ways to focus: a single session of any duration, a Pomodoro cycle (25 minutes of focus, a 5 minute break, and a longer break every 4 rounds — breaks start on their own), or a session bound to one specific task. A breathing exercise and countdown ease you in, and when the session completes you earn bricks based on its duration.
The timer keeps running in the background: switch apps or lock your phone and the time is still counted correctly, with a notification the moment it is done. Do Not Disturb can silence other apps for the length of the session. Only completed Pomodoro rounds count toward the daily round counter — single sessions and ones you end early do not.
What is Ambience?
Ambience sets the mood of a focus session. A scene fills the whole screen and brings its own sound: Rainy City (rain and fireplace), Midnight (city hum over brown noise), Dusk (birds and breeze), Snow (winter wind and pink noise) or Fog (fog horn and white noise). The Default scene is always available and is silent.
Under the Sound tab you can blend up to three layers at once — rain, fireplace, forest, waves, café, library, train, thunder, brown, pink or white noise — and set the level of each. The mix can follow the session rhythm, opening softly in the first 5 minutes and brightening in the last 2, and the scene can switch to Dusk on its own when your break starts. It is ambience, not music: no melody, no beat.
How do I build my city?
Earn bricks by completing tasks and focus sessions. Visit the Market tab to browse and purchase buildings, decorations, and roads. Then place them on your isometric grid in the Dovilo tab. Your city grows as your productivity grows!
Can I rearrange buildings?
You can demolish a building by tapping on it and selecting the demolish option. This refunds a portion of the bricks, and you can then place a new building wherever you like.
What does Dovilo Pro include?
Pro includes everything in the free tier, plus: the Windows and Mac desktop app, which is the full app on a full-size screen and also serves the AI task list your coding agents work out of, over its MCP server; the Focus Ambience Pack (5 scenes, 12 sound layers); the Full City Package (every building, decoration and upgrade); cloud sync across devices; advanced statistics; smart notification management; priority support; and all future updates. Both one-time content packs are included with Pro, not sold again. Unlimited tasks and categories and a zero-ad experience are free-tier features, not Pro ones, and there are no custom themes.
What are the pricing options?
Dovilo Pro is available as: Monthly ($2.49/month), Yearly ($19.99/year — best value, saves 33%), or Lifetime ($49.99 one-time payment). All plans include the same Pro features.
There are also one-time purchases that are not subscriptions: the Focus Ambience Pack ($4.99 — 5 scenes and 12 sound layers), the Full City Package ($4.99 — every building, decoration and upgrade), and AI task packs from $0.99. Both packs are already included with Pro.
Do I need the Focus Ambience Pack?
No. Focus sessions and Pomodoro cycles are free and unlimited, and the Default scene is always available — it is simply silent. The pack adds the 5 atmospheric scenes and the 12 sound layers you can blend three at a time. It is a one-time $4.99 purchase, and Pro subscribers already have it.
How do I cancel my subscription?
Subscriptions are managed through the Apple App Store or Google Play Store. To cancel, go to your device's subscription settings. You'll retain Pro access until the end of your current billing period.
What is Dovilo's MCP integration?
Dovilo Desktop (Pro) ships with a built-in Model Context Protocol server that runs locally on your machine. Any MCP-compatible client — Claude Code, Cursor, Claude Desktop, Windsurf, Codex CLI, Gemini CLI, and others — can connect and call Dovilo's tools: list_tasks, get_task, read_context, update_status, update_step, add_step, skip_step, append_note, and append_telemetry. Those tools reach AI tasks only — the jobs you write for an agent in the AI Tasks tab, inside a project. Your personal to-do list in My Tasks is a separate surface an agent cannot read, and no agent can create a task. Setup, the full tool reference and the trust boundaries are on the developer page.
How do I connect Claude Code, Cursor, or another AI agent?
Open Dovilo Desktop and go to Settings → AI → Connect AI. Pick your IDE and Dovilo generates the right config for it: Claude Desktop is auto-wired in one click; Claude Code, Cursor CLI, Codex CLI, and Gemini CLI get a single mcp add command; Cursor (GUI), Windsurf, and custom MCP clients get a JSON snippet to paste. Restart your AI client and it will see Dovilo as an available MCP server.
Which AI clients does Dovilo support?
The Connect AI flow has presets for Claude Desktop, Claude Code, Cursor (GUI & CLI), Windsurf, Codex CLI, and Gemini CLI. Anything else that speaks the MCP protocol can also connect using the generic snippet — Dovilo doesn't lock you to a specific vendor.
Can agents create or modify tasks I didn't authorize?
No. The MCP tool surface intentionally excludes task creation — agents can only read, update status, mark steps, leave notes, and report telemetry. You decide exactly which tasks an agent sees through a per-project scope and a project brief that the agent reads first. Disabling MCP in Desktop settings immediately terminates every active agent connection.
Does the MCP integration send my data to the cloud?
No. The MCP server runs entirely on your device and listens only on a local port. Dovilo itself doesn't transmit MCP traffic anywhere. The only external data flow is what your agent chooses to send to its own model provider (e.g. OpenAI, Anthropic) — that's governed by the agent and model provider's privacy policies, not ours.
Do I get notified when an agent works on my task?
Yes. You can choose between two notification modes: every step (each progress update the agent pushes) or start / finish / error only (quieter, summary-style). The AI Tasks tab is in the mobile app as well, so you can write an AI task from your phone and follow the same run there — step trail, agent notes and telemetry (tokens, cost, duration) all land on the task. Only the agent itself runs on the desktop.
Can Dovilo send task events to Slack, Linear, or my own service?
Yes. Dovilo Desktop fires HMAC-signed HTTPS webhooks on every task change — task.created and task.status_changed — so you can bridge Dovilo into Slack, Linear, n8n, LangGraph, or any custom receiver. Each delivery includes a Stripe-style X-Dovilo-Signature header for verification, a unique X-Dovilo-Delivery id for idempotency, FIFO ordering per task, and up to 5 retries on transient failures. Open a project → Webhooks in Desktop, paste your URL, generate a signing secret, and click Enable.
Full payload schema, signature verification examples (Node, Python, Go), and the retry policy live in the webhooks reference.
Is there an example webhook receiver I can copy from?
Yes — dovilo-langgraph-demo is an open-source LangGraph receiver that verifies the Dovilo signature, fans events out, and drives an agent through MCP end-to-end. There's also a walkthrough video covering the full setup: generating the signing secret, verifying signatures, and wiring up the agent loop.
Does Dovilo work offline?
Yes! Dovilo is offline-first. All your tasks, focus sessions, and city progress are stored locally on your device. You don't need an internet connection to use the app. Cloud sync is an optional Pro feature.
How does cloud sync work?
With Pro, you can sign in with Google or Apple and sync your data across multiple devices via Firebase. Your data is encrypted in transit and at rest. You can trigger a manual sync from Settings at any time.
Can I delete my account and data?
Yes. Go to Settings > Delete Account to permanently remove your account and all cloud-synced data. Local data is removed when you uninstall the app. Cloud data is fully deleted within 30 days of account deletion.
Does Dovilo have ads?
No. Dovilo is completely ad-free, both in the free tier and in Pro. We believe ads break focus, which is the opposite of what a productivity app should do.
Still have questions?
supportdovilo.app