Openmost Matomo MCP Client

📋 Description

This repository contains the client for the Openmost Matomo MCP server.
It enables you to connect Claude AI Desktop (or any other LLM that supports MCP — Model Context Protocol) to a Matomo analytics instance, via the Openmost MCP server.

You need to install and configure this client to act as a bridge between your Claude Desktop app and your Matomo analytics data.

---

🚀 Installation

1️⃣ Clone the repository

git clone https://github.com/openmost/matomo-mcp-client
cd matomo-mcp-client

2️⃣ Install dependencies

npm install

---

🔧 Configuration

Register the MCP client in Claude Desktop

You need to tell Claude Desktop about this MCP client by editing its configuration file.

📄 Location of the configuration file

You must add your MCP server config into the file:

claude_desktop_config.json

If it does not exist yet, you can create it.

Depending on your operating system, the file should be placed at:

OS	Path
Windows	C:\Users\your-name\AppData\Roaming\Claude\claude_desktop_config.json
Linux	~/.config/claude_desktop/claude_desktop_config.json
macOS	~/Library/Application\ Support/Claude/claude_desktop_config.json

---

📝 Example configuration

Below is an example of how to register the Openmost Matomo MCP client in claude_desktop_config.json.
You can adapt the paths, tokens, and URLs to fit your environment.

{
  "mcpServers": {
    "openmost-matomo-mcp": {
      "command": "node",
      "args": [
        "absolute/path/to/matomo-mcp-client.js",
        "--url=https://matomo-mcp.openmost.io",
        "--matomo-host=https://matomo.example.com",
        "--matomo-token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "--openmost-token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      ]
    }
  }
}

---

🔄 Restart Claude Desktop

After saving the configuration file, completely quit and restart Claude Desktop for the changes to take effect.

---

🎉 Usage

Once everything is configured and Claude has restarted:

• Open Claude Desktop.
• In the model selector, choose the MCP server named:
  openmost-matomo-mcp
• Start interacting!
  Your requests will now be processed through the Matomo MCP client and served by your Matomo analytics data.

---

📖 Resources

• Openmost
• Matomo Analytics
• Claude Desktop
• MCP Protocol