Connect an AI Assistant (MCP)

Version 1.2 | Updated: 2026-07-22 | App version: 0.2.x

DMH exposes an MCP server so an AI assistant — Claude Code, the Claude desktop/mobile app, or a voice assistant — can manage your tasks for you. Ask it in plain language ("what's due today?", "postpone my bank-call reminder", "create a task to call the bank at 3pm") and it calls DMH on your behalf.

Access is authenticated with a personal MCP token. Read and owner-mutation tools are scoped to your own tasks. The sole cross-owner exception is complete_task: an ASSIGNEE may submit completion for a private Challenge shared with them. You create tokens in Settings, and you can revoke any of them at any time.

1. What is MCP?

MCP (Model Context Protocol) is an open standard that lets AI assistants connect to external tools. DMH runs an MCP server at:

https://dmh.syntrope.app/api/mcp

When you connect an assistant with your token, it gains a set of task-management tools (see Available tools) scoped to your account, plus the private-Challenge assignee completion exception described below.

2. Create a token

Open Settings → Profile.
Find the AI Assistant (MCP) section.
Type a name that helps you recognize the token later (for example "Claude on my laptop" or "Phone voice assistant") and select Create token.
The token is shown once, in a dialog, in the form dmh_mcp_…. Copy it immediately with the Copy button — you will not be able to see it again. If you lose it, revoke it and create a new one.

Treat the token like a password. Anyone who has it can manage your tasks.

You say	What happens
"What's on my list today?"	Lists your active tasks (`list_tasks`).
"Do I have anything overdue?"	Lists tasks and checks their deadlines.
"Create a reminder to call the bank tomorrow at 3pm."	Creates a REMINDER task (`create_task`).
"Rename the bank task to 'call the mortgage department'."	Updates the task title (`update_task`).
"I finished the bank-call reminder, mark it done."	Completes the task (`complete_task`).
"Postpone my watchdog check-in."	Pushes the deadline out by the task's postpone period (`postpone_task`).
"Delete the old dentist reminder after confirming its title with me."	Deletes the task immediately (`delete_task`); deletion cannot be undone.

Tool	What it does
`ping`	Health check — confirms the connection works.
`list_tasks`	Lists your tasks with `skip`/`take`. The optional status filter runs after that page is fetched, so a filtered page can contain fewer than `take` results even when later matches exist.
`get_task`	Shows one of your tasks by id.
`create_task`	Creates any of the five task types with a strict, type-specific configuration.
`update_task`	Edits a task's title, description, start time, or status.
`complete_task`	Completes your task, or submits completion for a private Challenge assigned to you. Its optional `comment` is stored only as evidence for that shared private-Challenge assignee path; owner-task comments are ignored.
`postpone_task`	Pushes a task's next fire time out by its configured period.
`delete_task`	Deletes a task.

Field	Meaning
`title`	Required, non-blank task title (maximum 200 characters).
`description`	Optional description (maximum 5,000 characters).
`start_at`	Optional ISO 8601 date-time with an offset, such as `2026-08-01T09:00:00Z`.
`taskType`	`REMINDER`, `CHALLENGE`, `PUBLICATION`, `DEADMANS_SWITCH`, or `SERVICE_MONITOR`; defaults to `REMINDER`.
`postpone_period`	Optional positive postpone period in milliseconds.
`status`	Optional initial `INACTIVE` or `ACTIVE` status.
`isPublic`, `maxParticipants`, `iconUrl`	Optional safe common task fields.
`type_config`	Optional or required type-specific object described below. Its `type` must match `taskType`.

Task type	Primary `type_config` variants and fields
`REMINDER`	Optional. `mode` is `ALARM` (default), `POMODORO`, or `SPACED_REPETITION`; `soundEnabled` defaults to `true`. Exact mode fields and defaults are listed below.
`CHALLENGE`	Optional. `firstWarningMinutes`/`secondWarningMinutes` default to 5/2, `votingEnabled` defaults to `false`, and `schedule` optionally supplies canonical recurrence. Recurring schedules are materialized before activation.
`PUBLICATION`	Optional. Publication `content` and an optional `imageUrl`.
`DEADMANS_SWITCH`	Required. `recipientEmail`, `subject`, and `content`; `postponeShiftMode` defaults to `false`. It also accepts the warning fields and paired `archiveFile`/`archiveFileName`. This configuration remains redacted from tool results.
`SERVICE_MONITOR`	Required. `mode` is `URL` or `DEVICE`; `intervalMinutes` defaults to 60 (range 10–10,080) and `offlineAlertEnabled` defaults to `true`. Exact mode fields are listed below.

Connect an AI Assistant (MCP)

Connect an AI Assistant (MCP)

1. What is MCP?

2. Create a token

3. Connect an assistant

Claude Code (CLI)

Claude.ai custom connector (desktop and mobile, incl. voice)

4. Control your tasks by voice

Set up voice once

What to say — examples

Limits to know

5. Available tools

6. `create_task` schema

DEVICE liveness example

DEVICE alarm example

7. Safety limits

8. Revoke a token

9. Troubleshooting

Connect an AI Assistant (MCP)

1. What is MCP?

2. Create a token

3. Connect an assistant

Claude Code (CLI)

Claude.ai custom connector (desktop and mobile, incl. voice)

4. Control your tasks by voice

Set up voice once

What to say — examples

Limits to know

5. Available tools

6. create_task schema

DEVICE liveness example

DEVICE alarm example

7. Safety limits

8. Revoke a token

9. Troubleshooting

6. `create_task` schema