← All MCP tools

Suggest event matches

suggest_event_matches
Read-only

What it does

Rank likely task↔calendar-event pairs, best first, with the evidence behind each one. Pass task_id to ask 'which meeting is this task about', event_id to ask 'which task is this meeting about', or neither to sweep the whole board. Every suggestion carries a score (0–1), a confidence band, and reasons naming the signals that fired — shared wording, an attendee named in the task, the organiser's domain, an acronym, date proximity. Nothing is linked by calling this: it is deliberately a proposal. Titles rarely match outright, so read the reasons and confirm with link_task_to_event rather than trusting the ordering blindly; a 'medium' top result usually means the machine genuinely cannot tell and a human should.

Parameters

NameTypeRequiredDescription
task_idstringOptional

Rank events against this one task

event_idstringOptional

Rank tasks against this one event

fromstringOptional

Earliest local date to consider, YYYY-MM-DD

tostringOptional

Latest local date to consider, YYYY-MM-DD

min_scorenumberOptional

Drop suggestions below this score (default 0.15)

limitnumberOptional
include_linkedbooleanOptional

Also re-offer pairs that are already linked

Annotations

The hints the server sends with this tool. A host reads them to decide whether to ask you before a call.

Read-onlyreadOnlyHint: true
Changes nothing.
DestructivedestructiveHint: false
Only adds or reads; nothing already there is removed or overwritten.
IdempotentidempotentHint: —
Doesn't apply: the tool changes nothing.
Open worldopenWorldHint: false
Touches only your own Done account.

Which tokens can call it

A connection made with OAuth has full access. A token from Settings → Agent access → Extra MCP tokens can be narrowed, and a narrowed token never sees beyond its project or workspace.

  • Full accessAllowed
  • Read-only tokenAllowed
  • Single-project tokenRefused
  • Single-workspace tokenRefused

Try it

With Done connected, ask your assistant something like:

“Which of my tasks is tomorrow's 10am meeting about?”

Connect Done to your assistant

One MCP endpoint per account, over OAuth or a token. Step-by-step setup for each client:

MCP setup overview →