• DATA
  • LOGS
  • HUMAN
  • REPORTS

How to automate bulk data ingestion with your AI

Connect Matomo to your AI client once. After that, you just tell your agent what data to send, and it handles the batching.

Ask AI about this page

Short answer

How do I send multiple data points to Matomo at once?

You give your AI a list of events or metrics in chat, and it uses the track_bulk tool to push them all to your Matomo instance in one go. This replaces the need to write custom scripts or hit the API manually for every single event.

Where your data lands.

The results of your request.

The AI processes your instructions and routes the information to the right places in Matomo.

DATA

Batched ingestion

The track_bulk tool takes your raw list of events and sends them to Matomo. You get a clean, organized set of tracking data without manual entry.

LOGS

Confirmation of success

Your agent checks the response from Matomo after the bulk upload. You'll know immediately if the data landed or if a specific entry failed.

HUMAN

Manual review needed

If your data format is messy or missing required fields, the AI will stop and ask you to fix the input before it attempts the upload.

REPORTS

Updated analytics

Once the ingestion finishes, your Matomo dashboards reflect the new data. You can then ask your AI to summarize the changes.

The workflow

What your AI does when the data arrives.

The AI acts as the bridge between your conversation and the Matomo API.

  1. Parse the input

    Your agent reads the list of data points you provided in the chat. It identifies the specific metrics, IDs, or event names you want to track.

    track_bulk

  2. Format for Matomo

    The AI structures your plain text or spreadsheet data into the exact JSON format the Matomo API expects.

    track_bulk

  3. Execute the batch

    The agent triggers the bulk upload, sending the entire payload to your Matomo instance in a single request.

    track_bulk

  4. Verify the upload

    The AI looks at the server response to ensure every data point was accepted. It reports any errors back to you.

    track_bulk

Try it

Copy these to start.

Use these prompts to trigger the ingestion process.

Starting points

These are templates. Swap out the bracketed info with your actual event names or data lists.

Matomo Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_FsRrwfavS2xRx1njKwXMHoEJtqrlaHQYlA74EPOZ/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Matomo capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "matomo-alternative-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_FsRrwfavS2xRx1njKwXMHoEJtqrlaHQYlA74EPOZ/mcp"
    }
  }
}
Copy into chat04

  • Use track_bulk to send these user clicks to Matomo: [paste list of clicks]

  • Send this batch of website visitor data to my Matomo instance: [paste data]

  • I have a list of 50 new events from a CSV. Use track_bulk to upload them to Matomo.

  • Check if these specific tracking IDs can be sent to Matomo using track_bulk: [list of IDs]

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Matomo once, then ask.

You only need to link your Matomo account once. After that, your AI handles all the heavy lifting through the Vinkius host.

Connect Matomo to your AI

FAQ

How this task behaves.

  • 01

    Can the AI delete existing data in Matomo?

    No. This connector only has the ability to send data via track_bulk. It cannot delete or modify existing records.

  • 02

    Does the AI handle the API authentication for me?

    Yes. Once you connect the Matomo MCP, your credentials stay secure and the AI uses them automatically to authorize the bulk requests.

  • 03

    What happens if my data list is too large?

    The AI will attempt to process the list, but if the payload exceeds Matomo's limits, the agent will notify you of the error.

  • 04

    Can I send data to multiple Matomo instances at once?

    No. The AI sends data to the specific Matomo instance you have connected.

  • 05

    Can the AI create new Matomo users?

    No. The available tools are limited to data ingestion through track_bulk.

  • More questions about Matomo? The Connector page answers them. See everything the Matomo Connector can do

Connect Matomo to Claude, Cursor, ChatGPT & more