https://github.com/openmost/matomo-mcp-client
https://github.com/openmost/matomo-mcp-client
Last synced: 11 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/openmost/matomo-mcp-client
- Owner: openmost
- Created: 2025-07-04T21:29:04.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-07-04T22:20:51.000Z (11 months ago)
- Last Synced: 2025-07-04T23:27:00.377Z (11 months ago)
- Language: Python
- Size: 4.88 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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](https://github.com/modelcontext/protocol)) to a [Matomo](https://matomo.org/) 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
```bash
git clone https://github.com/openmost/matomo-mcp-client
cd matomo-mcp-client
```
### 2️⃣ Install dependencies
```bash
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.
```json
{
"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](https://openmost.io)
- [Matomo Analytics](https://matomo.org)
- [Claude Desktop](https://claude.ai/download)
- [MCP Protocol](https://github.com/modelcontext/protocol)