Каталог MCP
mikusnuz/umami-mcp

mikusnuz/umami-mcp

Name: mikusnuz/umami-mcp
Availability: InStock
Author: mikusnuz

MCP сервер для Umami Analytics с полным покрытием API v2. Включает 66 инструментов: от управления сайтами до реалтайм-мониторинга и администрирования пользователей. Подходит для автоматизации веб-аналитики через ИИ-помощников.

README

66 инструментов

Версии

Установить сервер

English | 한국어

umami-mcp

Full-coverage Model Context Protocol (MCP) server for Umami Analytics API v2.

Unlike existing Umami MCP implementations (read-only, ≤5 tools), this server provides 66 tools, 2 resources, and 2 prompts covering the entire Umami API — websites CRUD, stats, sessions, events, event-data, session-data, reports, user management, teams, realtime, account, and more.

When to Use

Use this MCP when you need to:

"Show me website analytics for the last 7 days" — get stats, pageviews, and metrics with date filters
"Which pages got the most views this month?" — query aggregated metrics by URL
"Compare traffic between two date ranges" — use the traffic_compare prompt or get_stats with different ranges
"Set up a new website in Umami" — create and configure tracked websites
"Get real-time active visitors" — check active visitors and real-time data
"Export analytics report" — create, run, and retrieve reports (funnel, retention, UTM, goals, revenue, attribution)
"Track a custom event from the server" — send events or batch events programmatically
"Manage team access to analytics" — create teams, add users and websites to teams

Инструменты были проиндексированы: 04.09.2026

add_team_user

Добавить пользователя в команду

Параметры

rolestringобязательный
Role in the team: 'team-owner' or 'team-member'
teamIdstringобязательный
Team UUID
userIdstringобязательный
User UUID to add

add_team_website

Добавить сайт в команду

Параметры

teamIdstringобязательный
Team UUID
websiteIdstringобязательный
Website UUID to add to the team

batch_events

Отправляет несколько событий или просмотров страниц в одном пакетном запросе.

Параметры

eventsobject[]обязательный
Array of events to send

create_report

Создать и сохранить новый отчёт

Параметры

descriptionstring
Report description
namestringобязательный
Report name
parametersobject
Report-specific parameters (JSON object)
typeenumобязательный
Report type
websiteIdstringобязательный
Website UUID

create_team

Создать новую команду

Параметры

namestringобязательный
Team name

create_user

Создать нового пользователя (только для администратора)

Параметры

passwordstringобязательный
Password for the new user
rolestring
User role: 'admin' or 'user' (default: 'user')
usernamestringобязательный
Username for the new user

create_website

Создать новый сайт для отслеживания в Umami

Параметры

domainstringобязательный
Website domain (e.g. 'example.com')
namestringобязательный
Display name for the website
shareIdstring
Unique share ID for public access

delete_report

Удалить сохранённый отчёт

Параметры

reportIdstringобязательный
Report UUID to delete

delete_team

Удалить команду

Параметры

teamIdstringобязательный
Team UUID to delete

delete_user

Удалить пользователя (только для администратора)

Параметры

userIdstringобязательный
User UUID to delete

delete_website

Удалить сайт из Umami

Параметры

websiteIdstringобязательный
Website UUID to delete

get_active_visitors

Получить количество активных посетителей на сайте

Параметры

websiteIdstringобязательный
Website UUID

get_daterange

Получить диапазон дат доступных данных для веб-сайта

Параметры

websiteIdstringобязательный
Website UUID

get_event_data_events

Получить данные о событиях: события (пользовательские названия событий и их количество) для веб-сайта

Параметры

endAtnumberобязательный
End timestamp in milliseconds
eventNamestring
Filter by event name
startAtnumberобязательный
Start timestamp in milliseconds
websiteIdstringобязательный
Website UUID

get_event_data_fields

Получить поля данных событий (ключи свойств и их типы данных) для веб-сайта

Параметры

endAtnumberобязательный
End timestamp in milliseconds
eventNamestring
Filter by event name
startAtnumberобязательный
Start timestamp in milliseconds
websiteIdstringобязательный
Website UUID

get_event_data_stats

Получить статистику данных событий (суммарные подсчеты) для сайта

Параметры

endAtnumberобязательный
End timestamp in milliseconds
eventNamestring
Filter by event name
startAtnumberобязательный
Start timestamp in milliseconds
websiteIdstringобязательный
Website UUID

get_event_data_values

Получить значения данных событий (агрегированные количества для конкретного свойства) для веб-сайта

Параметры

endAtnumberобязательный
End timestamp in milliseconds
eventNamestring
Filter by event name
propertyNamestring
Filter by property name
startAtnumberобязательный
Start timestamp in milliseconds
websiteIdstringобязательный
Website UUID

get_events

Получить данные о событиях для веб-сайта за период времени

Параметры

endAtnumberобязательный
End timestamp in milliseconds
startAtnumberобязательный
Start timestamp in milliseconds
timezonestring
Timezone (e.g. 'Asia/Seoul')
unitenumобязательный
Time grouping unit
urlstring
Filter by URL path
websiteIdstringобязательный
Website UUID

get_event_series

Получить метрики событий во времени (данные временных рядов событий) для веб-сайта

Параметры

endAtnumberобязательный
End timestamp in milliseconds
eventNamestring
Filter by event name
startAtnumberобязательный
Start timestamp in milliseconds
timezonestring
Timezone (e.g. 'Asia/Seoul')
unitenumобязательный
Time grouping unit
urlstring
Filter by URL path
websiteIdstringобязательный
Website UUID

get_event_values

Получает значения свойств событий или сессий для веб-сайта.

Параметры

endAtnumberобязательный
End timestamp in milliseconds
startAtnumberобязательный
Start timestamp in milliseconds
websiteIdstringобязательный
Website UUID

get_me

Получить информацию профиля текущего аутентифицированного пользователя

Параметры

Без параметров.

get_metrics

Получает агрегированные метрики для сайта (например, топ страниц, браузеры, страны, устройства, ОС, события).

Параметры

endAtnumberобязательный
End timestamp in milliseconds
limitnumber
Max results to return (default 500)
referrerstring
Filter by referrer
startAtnumberобязательный
Start timestamp in milliseconds
typeenumобязательный
Metric type to aggregate
urlstring
Filter by URL path
websiteIdstringобязательный
Website UUID

get_my_teams

Получает список команд, в которые входит текущий пользователь.

Параметры

pagenumber
Page number (1-based)
pageSizenumber
Results per page
querystring
Search query to filter teams

get_my_websites

Получить список сайтов, принадлежащих текущему пользователю

Параметры

pagenumber
Page number (1-based)
pageSizenumber
Results per page
querystring
Search query to filter websites

get_pageviews

Получает количество просмотров страниц и сеансов для веб-сайта с разбивкой по времени.

Параметры

endAtnumberобязательный
End timestamp in milliseconds
referrerstring
Filter by referrer
startAtnumberобязательный
Start timestamp in milliseconds
timezonestring
Timezone (e.g. 'Asia/Seoul')
unitenumобязательный
Time grouping unit
urlstring
Filter by URL path
websiteIdstringобязательный
Website UUID

get_realtime

Получить данные о сайте в реальном времени (за последние 30 минут). Возвращает текущих посетителей, активные URL, источники перехода, страны и события.

Параметры

websiteIdstringобязательный
Website UUID

get_report

Получить подробности конкретного сохранённого отчёта

Параметры

reportIdstringобязательный
Report UUID

get_session

Получить сведения о конкретной сессии

Параметры

sessionIdstringобязательный
Session UUID
websiteIdstringобязательный
Website UUID

get_session_activity

Получить журнал активности для конкретной сессии (посещённые страницы, вызванные события)

Параметры

sessionIdstringобязательный
Session UUID
websiteIdstringобязательный
Website UUID

get_session_data_properties

Получить имена свойств данных сессии и их типы данных для веб-сайта

Параметры

endAtnumberобязательный
End timestamp in milliseconds
startAtnumberобязательный
Start timestamp in milliseconds
websiteIdstringобязательный
Website UUID

get_session_data_values

Получить значения данных сессии (агрегированные подсчеты для свойств сессии) для веб-сайта

Параметры

endAtnumberобязательный
End timestamp in milliseconds
propertyNamestring
Filter by property name
startAtnumberобязательный
Start timestamp in milliseconds
websiteIdstringобязательный
Website UUID

get_session_properties

Получить пользовательские свойства, прикреплённые к конкретной сессии.

Параметры

sessionIdstringобязательный
Session UUID
websiteIdstringобязательный
Website UUID

get_sessions

Получить данные сессии для сайта

Параметры

endAtnumberобязательный
End timestamp in milliseconds
orderBystring
Field to order by
pagenumber
Page number (1-based)
pageSizenumber
Results per page
querystring
Search query
startAtnumberобязательный
Start timestamp in milliseconds
websiteIdstringобязательный
Website UUID

get_session_stats

Получает сводную статистику сессий для сайта (общее количество сессий, уникальных посетителей и т.д.).

Параметры

endAtnumberобязательный
End timestamp in milliseconds
referrerstring
Filter by referrer
startAtnumberобязательный
Start timestamp in milliseconds
urlstring
Filter by URL path
websiteIdstringобязательный
Website UUID

get_sessions_weekly

Получить еженедельные данные о сессиях для веб-сайта

Параметры

endAtnumberобязательный
End timestamp in milliseconds
startAtnumberобязательный
Start timestamp in milliseconds
websiteIdstringобязательный
Website UUID

get_share

Получить данные общего веб-сайта по share ID (публичный доступ, для самого share аутентификация не требуется)

Параметры

shareIdstringобязательный
The share ID of a publicly shared website

get_stats

Получить сводную статистику для веб-сайта (pageviews, visitors, visits, bounces, totaltime)

Параметры

endAtnumberобязательный
End timestamp in milliseconds
referrerstring
Filter by referrer
startAtnumberобязательный
Start timestamp in milliseconds
urlstring
Filter by URL path
websiteIdstringобязательный
Website UUID

get_team

Получить подробности о конкретной команде

Параметры

teamIdstringобязательный
Team UUID

get_team_user

Получить сведения о конкретном участнике команды

Параметры

teamIdstringобязательный
Team UUID
userIdstringобязательный
User UUID

get_user

Получить сведения о конкретном пользователе (только для администраторов)

Параметры

userIdstringобязательный
User UUID

get_user_teams

Получить список команд, в которых состоит пользователь (только для администратора)

Параметры

pagenumber
Page number (1-based)
pageSizenumber
Results per page
querystring
Search query to filter teams
userIdstringобязательный
User UUID

get_user_usage

Получить статистику использования для конкретного пользователя (только для администраторов)

Параметры

endAtnumber
End timestamp in milliseconds
startAtnumber
Start timestamp in milliseconds
userIdstringобязательный
User UUID

get_user_websites

Получить список сайтов, к которым у пользователя есть доступ (только для администратора)

Параметры

pagenumber
Page number (1-based)
pageSizenumber
Results per page
querystring
Search query to filter websites
userIdstringобязательный
User UUID

get_website

Получает детали конкретного веб-сайта по ID.

Параметры

websiteIdstringобязательный
Website UUID

get_website_reports

Получить все отчёты, связанные с конкретным веб-сайтом

Параметры

websiteIdstringобязательный
Website UUID

heartbeat

Проверяет, запущен ли сервер Umami и исправен ли он.

Параметры

Без параметров.

join_team

Присоединиться к команде по коду доступа

Параметры

accessCodestringобязательный
Team access/invite code

list_reports

Перечислить все сохранённые отчёты.

Параметры

orderBystring
Field to order by
pagenumber
Page number (1-based)
pageSizenumber
Results per page

list_teams

Вывести список всех команд

Параметры

orderBystring
Field to order by (e.g. 'name', 'createdAt')
pagenumber
Page number (1-based)
pageSizenumber
Results per page (default 10)
querystring
Search query to filter teams

list_team_users

Вывести список всех участников команды

Параметры

pagenumber
Page number (1-based)
pageSizenumber
Results per page
querystring
Search query to filter members
teamIdstringобязательный
Team UUID

list_team_websites

Выведи список всех сайтов, принадлежащих команде.

Параметры

pagenumber
Page number (1-based)
pageSizenumber
Results per page
querystring
Search query to filter websites
teamIdstringобязательный
Team UUID

list_users

Вывести список всех пользователей (только для администратора)

Параметры

orderBystring
Field to order by (e.g. 'username', 'createdAt')
pagenumber
Page number (1-based)
pageSizenumber
Results per page (default 10)
querystring
Search query to filter users

list_websites

Перечисли все сайты, отслеживаемые в Umami.

Параметры

orderBystring
Field to order by (e.g. 'name', 'domain')
pagenumber
Page number (1-based)
pageSizenumber
Results per page (default 10)
querystring
Search query to filter websites

remove_team_user

Удалить пользователя из команды

Параметры

teamIdstringобязательный
Team UUID
userIdstringобязательный
User UUID to remove

remove_team_website

Удалить сайт из команды

Параметры

teamIdstringобязательный
Team UUID
websiteIdstringобязательный
Website UUID to remove from the team

reset_website

Сбросить сайт, удалив все его аналитические данные (необратимо)

Параметры

websiteIdstringобязательный
Website UUID to reset

run_report

Выполняет отчет по типу и получает результаты (funnel, retention, utm, goals, insights, revenue, journey, attribution)

Параметры

parametersobjectобязательный
Report-specific parameters (varies by type)
typeenumобязательный
Report type to run
websiteIdstringобязательный
Website UUID

send_event

Отправляет пользовательское событие или просмотр страницы в Umami (полезно для отслеживания на стороне сервера).

Параметры

eventDataobject
Custom event data as key-value pairs
eventNamestring
Custom event name (omit for pageview)
hostnamestringобязательный
Hostname of the site (e.g. 'example.com')
languagestring
Browser language (e.g. 'en-US')
referrerstring
Referrer URL
titlestring
Page title
urlstringобязательный
URL path (e.g. '/checkout')
websiteIdstringобязательный
Website UUID (used as the 'website' field in payload)

transfer_website

Передать владение сайтом другому пользователю

Параметры

userIdstringобязательный
Target user UUID to transfer ownership to
websiteIdstringобязательный
Website UUID to transfer

update_my_password

Обновить пароль текущего пользователя

Параметры

currentPasswordstringобязательный
Current password
newPasswordstringобязательный
New password

update_report

Обновить существующий сохранённый отчёт

Параметры

descriptionstring
Report description
namestring
Report name
parametersobject
Report-specific parameters (JSON object)
reportIdstringобязательный
Report UUID
typeenum
Report type
websiteIdstring
Website UUID

update_team

Обновить название команды

Параметры

namestringобязательный
New team name
teamIdstringобязательный
Team UUID

update_team_user

Обновить роль участника команды

Параметры

rolestringобязательный
New role: 'team-owner' or 'team-member'
teamIdstringобязательный
Team UUID
userIdstringобязательный
User UUID

update_user

Обновить имя пользователя, пароль или роль (только для администратора)

Параметры

passwordstring
New password
rolestring
New role: 'admin' or 'user'
userIdstringобязательный
User UUID
usernamestring
New username

update_website

Обнови конфигурацию существующего сайта.

Параметры

domainstring
New domain
namestring
New display name
shareIdstring
Share ID (set to null to remove)
websiteIdstringобязательный
Website UUID

verify_auth

Проверяет валидность текущего токена аутентификации.

Параметры

Без параметров.

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@mikusnuz/umami-mcp"
  ],
  "env": {
    "UMAMI_URL": "https://analytics.example.com",
    "UMAMI_USERNAME": "admin",
    "UMAMI_PASSWORD": "your-password"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

Информация о сервере

Номер в рейтинге: #198
Звезд на Github: 6
Форков на Github: 1
Загрузок: 1 826
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 04.09 в 01:21
Идентификатор: rzK3vMYTfPGKeR4w
Категории: Инструменты для разработчиков, Исследования и данные, Маркетинг, Мониторинг, Платформы данных