Get contact history
The contact timeline: emails sent and read, forms submitted, imports, segment and campaign changes.
MCP tool mautic_read → get_contact_history
read
Returns the events of the contact History, newest first, with the event label Mautic shows (Email Sent, Email Read, Form Submitted, Imported, Contact Created By Source, Do Not Contact and others). include and exclude work like the source filters on the page. Pass next_cursor back as cursor for older events.
Parameters
| Name | Type | Description |
|---|---|---|
| contact_id integer required | integer | Contact ID from list_contacts. |
| include string | string | Event source to include, as in Include events by source. |
| exclude string | string | Event source to leave out, as in Exclude events by source. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "mautic_read",
"arguments": {
"operation": "get_contact_history",
"arguments": {
"contact_id": 1
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"events": [
{
"event": "Email Read",
"detail": "October newsletter",
"at": "2026-10-21T09:14:00Z"
},
{
"event": "Segment Membership Change",
"detail": "Added to webinar-leads",
"at": "2026-10-14T11:30:00Z"
},
{
"event": "Imported",
"detail": "webinar-signups.csv",
"at": "2026-10-14T11:29:00Z"
}
],
"next_cursor": null
},
"isError": false
}