Integration · Analytics and data
AI agents for Matomo
Read a website's visits, pages, traffic sources, locations, devices, goals and live visitors from Matomo On-Premise or Matomo Cloud with the Reporting API, run any other read report, and add annotations.
- Actions
- 13
- Read
- 12
- Write
- 1
Actions
What your agents can do in Matomo
13 actions. Each one is a tool your agents can call and a step your workflows can run.
Read 12
Look things up. Nothing changes.
List websites
Lists the websites (measurables) this token can view.
Get visits summary
The main numbers for a period: nb_visits, nb_uniq_visitors, nb_users, nb_actions, bounce_rate (like "45%"), nb_actions_per_visit, avg_time_on_site (seconds) and max_actions.
Get top pages
The most viewed page URLs for a period, flattened.
Get traffic sources
Where visits came from for a period: channel types (direct, search, websites, social, campaigns), referring websites, search engines, social networks, campaigns or search keywords.
Get visitor locations and devices
Visits split by country, region, city, device type, browser, operating system or screen resolution for a period.
List goals
Lists the website's goals.
Get goal conversions
Conversions for all goals, or one goal, over a period.
Get live visitor counts
Visits, actions, unique visitors and converted visits in the last N minutes (30 by default).
Get recent visits
The latest visits with their actions (raw visitor log), newest first, optionally for a period and segment.
Get a visitor profile
One visitor's profile across visits by their 16-character visitor ID (from "Get recent visits").
Run any report
Calls any Reporting API read method by name (Module.getSomething), for reports the other actions do not cover.
List annotations
Notes people added to the evolution graph for a period (campaign launches, outages).
Write 1
Create, change or send.
Add an annotation
Adds a note to the website's evolution graph on a date, like "Spring campaign launched" (needs write access to the website).
A person can approve first
Any write action can be set to wait for a person's approval before it runs, so an agent asks before it changes anything.
Connection
How it connects
Connect it once in the console, then give it to the agents and workflows that need it.
Enter the sign-in details Matomo gives you for its API.
What you enter
- Auth token (token_auth)
Settings
- Matomo address
- Default website ID
Kept safe
- Credentials are stored encrypted with your organization's own keys.
- They are opened only by the process that makes the call, at the moment it runs, and never go into a prompt or the browser.
- Calls go only to the tool's own servers.
Ideas
Ideas to start with
Starting points made only from the actions above. Mix them with any other tool your agents can use.
- 01
Ask about your Matomo data
Ask a question in plain words. The agent can list websites, get visits summary or get top pages in Matomo, then answers with what it found.
- 02
Let an agent update Matomo
Have the agent add an annotation in Matomo as part of a larger task. Turn on approval and a person signs off on each change first.
- 03
Share what it finds in Slack
Give one agent Matomo and Slack: it can list websites in Matomo and post a summary to a Slack channel in the same run.
Works well with
More Analytics and data tools
- Google Analytics4 actionsRun Google Analytics 4 reports (users, sessions, views, conversions by page, source, country …), see who is on a site right now, and find the properties a person can read, signed in with the person's own Google account.
- Mixpanel4 actionsSend events to a Mixpanel project and query event counts, segmentation and saved Insights reports, in the US, EU or India data residency, with a service account.
- Amplitude14 actionsSend events to an Amplitude project and read its analytics: event counts and segmentation, funnels, retention, active users, saved charts, cohorts and one user's activity, in the US or EU data center.
- PostHog5 actionsQuery product analytics with HogQL, list recent events and persons, check which feature flags a user gets, and add annotations, in a PostHog Cloud project (US or EU) with a personal API key.
- Power BI5 actionsList Power BI workspaces and semantic models, refresh a model, push rows into a push dataset and run DAX queries, as the signed-in person.
- Tableau10 actionsFind workbooks, views and published data sources on Tableau Cloud or Tableau Server, read a view's data as CSV, query a published data source with the VizQL Data Service, search content through the Metadata API.
FAQ
Matomo and MyDeepAgents
Can MyDeepAgents connect to Matomo?
Yes. The Matomo connector has 13 actions: 12 read and 1 makes changes. Your agents can call them as tools, and your workflows can run them as steps.
How do I connect Matomo?
Enter the sign-in details Matomo gives you for its API. You'll need: Auth token (token_auth). The connection also asks for: Matomo address and Default website ID. Credentials are stored encrypted with your organization's own keys and are opened only at the moment of a call.
Can an agent change data in Matomo without asking?
Only if you let it. Its one action that changes data can be set to wait for a person's approval before it runs.
Can I use Matomo in workflows as well as agents?
Yes. Every Matomo action also works as a step in a workflow, and the same connection serves your agents and your workflows.
Early access
Put Matomo to work
Connect it in a few minutes, give an agent the actions it needs, and decide which changes wait for a person.