MCP
Connect an MCP-compatible client to https://app.diary.tools/api/mcp using Streamable HTTP.
Interactive clients can use Cognito OAuth. For clients that require a token, create an API key under Subscription → API keys and send it as Authorization: Bearer <token>. The key is shown once; keep it private. Integrations → Agents provides a configuration snippet.
Tools
| Tool | Inputs | Behavior |
|---|---|---|
list_contacts | optional limit, offset | Compact shared contact directory; default/max limit 100 |
open_threads | none | Contacts waiting on you or on them |
search_contacts | q, optional limit, offset | Fuzzy search; minimum 2 characters, default 20/max 50 results |
get_contact | contactId | Full contact details and research |
update_contact | contactId, fields | Update selected fields; REMOVE or null clears optional fields |
Use stable contact IDs returned by the directory tools. Contact tools operate across the subscription. Channel links use { type: "channel", id, name }.
MCP does not send or manage outbound email. Read and write operations respect the authenticated subscription’s permissions.