{"id":38917564,"url":"https://github.com/kitconcept/matomo-mcp","last_synced_at":"2026-01-17T15:29:12.459Z","repository":{"id":326552711,"uuid":"1105145594","full_name":"kitconcept/matomo-mcp","owner":"kitconcept","description":null,"archived":false,"fork":false,"pushed_at":"2025-12-15T10:29:46.000Z","size":88,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-26T17:45:26.694Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kitconcept.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-27T07:46:17.000Z","updated_at":"2025-11-29T11:27:51.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kitconcept/matomo-mcp","commit_stats":null,"previous_names":["kitconcept/matomo-mcp"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/kitconcept/matomo-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kitconcept%2Fmatomo-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kitconcept%2Fmatomo-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kitconcept%2Fmatomo-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kitconcept%2Fmatomo-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kitconcept","download_url":"https://codeload.github.com/kitconcept/matomo-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kitconcept%2Fmatomo-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28511480,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T13:38:16.342Z","status":"ssl_error","status_checked_at":"2026-01-17T13:37:44.060Z","response_time":85,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-17T15:29:09.971Z","updated_at":"2026-01-17T15:29:12.444Z","avatar_url":"https://github.com/kitconcept.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Matomo MCP Server\n\n[![Tests](https://github.com/kitconcept/matomo-mcp/actions/workflows/test.yml/badge.svg)](https://github.com/kitconcept/matomo-mcp/actions/workflows/test.yml)\n[![Code Quality](https://github.com/kitconcept/matomo-mcp/actions/workflows/lint.yml/badge.svg)](https://github.com/kitconcept/matomo-mcp/actions/workflows/lint.yml)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nA Model Context Protocol (MCP) server that provides access to Matomo's Reporting API.\n\n## Features\n\n- Access Matomo reporting data through MCP tools\n- Query website statistics, visitor information, and analytics data\n- Support for multiple Matomo sites\n- Secure API token authentication\n\n## Installation\n\n```bash\npip install -e .\n```\n\n## Configuration\n\nThe server requires the following environment variables:\n\n- `MATOMO_URL`: Your Matomo instance URL (e.g., `https://analytics.example.com`)\n- `MATOMO_TOKEN`: Your Matomo API authentication token\n\nYou can obtain an API token from your Matomo instance under:\nPersonal Settings → Security → Auth tokens\n\n## Usage with Claude Desktop\n\nAdd this to your Claude Desktop configuration:\n\n### MacOS\n`~/Library/Application Support/Claude/claude_desktop_config.json`\n\n### Windows\n`%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"matomo\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"matomo_mcp\"],\n      \"env\": {\n        \"MATOMO_URL\": \"https://your-matomo-instance.com\",\n        \"MATOMO_TOKEN\": \"your_api_token_here\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\n### get_site_info\nGet information about a specific Matomo site.\n\n**Parameters:**\n- `site_id`: The ID of the site (integer)\n\n### get_visits_summary\nGet a summary of visits for a site within a date range.\n\n**Parameters:**\n- `site_id`: The ID of the site (integer)\n- `period`: Time period (day, week, month, year, range)\n- `date`: Date or date range (e.g., \"2024-01-01\", \"last30\", \"today\")\n\n### get_page_urls\nGet the most visited page URLs for a site.\n\n**Parameters:**\n- `site_id`: The ID of the site (integer)\n- `period`: Time period (day, week, month, year, range)\n- `date`: Date or date range\n- `limit`: Maximum number of results (default: 10)\n\n### get_countries\nGet visitor statistics by country.\n\n**Parameters:**\n- `site_id`: The ID of the site (integer)\n- `period`: Time period (day, week, month, year, range)\n- `date`: Date or date range\n- `limit`: Maximum number of results (default: 10)\n\n### get_user_settings\nGet visitor browser and device information.\n\n**Parameters:**\n- `site_id`: The ID of the site (integer)\n- `period`: Time period (day, week, month, year, range)\n- `date`: Date or date range\n\n### query_custom_report\nExecute a custom Matomo API query.\n\n**Parameters:**\n- `method`: Matomo API method (e.g., \"Actions.getPageUrls\")\n- `site_id`: The ID of the site (integer)\n- `period`: Time period (day, week, month, year, range)\n- `date`: Date or date range\n- `additional_params`: Optional JSON object with additional parameters\n\n## Development\n\nInstall development dependencies:\n\n```bash\npip install -e \".[dev]\"\n```\n\nRun tests:\n\n```bash\npytest\n```\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkitconcept%2Fmatomo-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkitconcept%2Fmatomo-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkitconcept%2Fmatomo-mcp/lists"}