Integration

Umami integration

Umami is privacy-focused, open-source web analytics; this API is that of a self-hosted Umami instance. Read website stats, pageviews, ranked metrics (pages, referrers, countries, UTM), real-time activity, sessions, events and custom event or session properties, funnels, goals, journeys, retention, attribution, revenue, Web Vitals and front-end errors; manage websites, teams and members, tracked links, pixels, boards, segments, annotations and public share links (anyone holding a share link can view the shared stats). Umami Cloud (api.umami.is/v1) uses other paths and is not covered. Left out: sign-in, two-factor and admin routes, user management, API key and password routes, the tracking ingestion routes (send, batch, record), session replay recordings, the ZIP export, the ad-hoc funnel report (its steps format is undocumented; saved funnels are covered) and the generic share create (its shareType codes are undocumented; each resource has its own share tool). Analytics rows describe visitors (location, device, distinct ids). Authentication is an Umami API key (Settings, API keys) sent as a Bearer token to the instance URL.

Connect Umami How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Umami.Built from the 143 Umami tools below, on the connection you add once.

What you can do with Umami

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Share, 9 operations

create_board_shareCreate board sharePOSTCreates a public share link for a board: anyone holding the link can view the board without signing in. Returns its id and slug.
create_link_shareCreate link sharePOSTCreates a public share link for a tracked link's stats: anyone holding the link can view them without signing in.
create_pixel_shareCreate pixel sharePOSTCreates a public share link for a tracking pixel's stats: anyone holding the link can view them without signing in.
create_website_shareCreate website sharePOSTCreates a public share link for a website's dashboard: anyone holding the link can view the stats without signing in.
delete_shareDelete shareDELETEDeletes a share link; the shared page stops being public. Cannot be undone.
get_shareGet shareGETReturns a share's configuration by its ID after checking access to the shared resource.
list_board_sharesList board sharesGETLists the public share links of a board (anyone holding a share link can view the board without signing in).
list_link_sharesList link sharesGETLists the public share links of a tracked link's stats (anyone holding a share link can view them without signing in).
list_pixel_sharesList pixel sharesGETLists the public share links of a tracking pixel's stats (anyone holding a share link can view them without signing in).

Board, 6 operations

clone_boardClone boardPOSTCreates a copy of a board with optional changes to its name, description, and configuration. Removes invalid report references from the copy.
create_boardCreate boardPOSTCreates a board with a name, type, and configuration, optionally assigned to a team. Validates access to its referenced resources and reports.
delete_boardDelete boardDELETEPermanently deletes a board. Cannot be undone.
get_boardGet boardGETReturns the specified board and its configuration.
list_boardsList boardsGETReturns a paginated list of the current user's boards, with search and sorting options.
list_team_boardsList team boardsGETReturns a paginated list of boards belonging to the specified team, with search and sorting options.

Event series, 5 operations

get_event_array_seriesGet event array seriesGETCounts individual values in an array property for the specified event, grouped by value and time interval.
get_event_date_seriesGet event date seriesGETCounts occurrences of dates stored in the specified event property, grouping by the property's date value within the selected event date range.
get_event_numeric_seriesGet event numeric seriesGETReturns the sum, average, or count of a numeric property for the specified event, grouped by time interval.
get_event_property_seriesGet event property seriesGETCounts occurrences of string values in the specified event property, grouped by value and time interval.
get_event_seriesGet event seriesGETReturns counts grouped by event name and time interval, optionally limited to the most frequent event names.

Tracked link, 5 operations

create_linkCreate linkPOSTCreates a tracked link with a name, destination URL, and slug, optionally assigned to a team.
delete_linkDelete linkDELETEPermanently deletes a tracked link; its short URL stops redirecting. Cannot be undone.
get_linkGet linkGETReturns the specified tracked link, including its destination URL and slug.
list_linksList linksGETReturns a paginated list of the current user's tracked links, with search and sorting options.
list_team_linksList team linksGETReturns a paginated list of tracked links belonging to the specified team, with search and sorting options.

Annotation, 4 operations

create_annotationCreate annotationPOSTAdds a dated note to the website, optionally marking it as an all-day annotation.
delete_annotationDelete annotationDELETEDeletes the specified dated note from the website.
get_annotationGet annotationGETReturns the date, all-day setting, and note for a specific website annotation.
list_annotationsList annotationsGETReturns a paginated list of dated notes for the website, optionally filtered by date range or search text.

Funnel, 4 operations

create_funnelCreate funnelPOSTSaves a named funnel for the website with an optional description, its ordered steps, and the conversion window.
delete_funnelDelete funnelDELETEDeletes the specified saved funnel from the website after checking the caller's permissions.
get_funnelGet funnelGETReturns a saved funnel of the website (name, description, steps, conversion window) as Umami returns it; Umami's contract documents only ok, so the answer is passed through whole.
list_funnelsList funnelsGETReturns a paginated list of the saved funnels for the website, optionally filtered by search text.

Goal, 4 operations

create_goalCreate goalPOSTSaves a named goal for the website with an optional description and the goal type and value to track.
delete_goalDelete goalDELETEDeletes the specified saved goal from the website after checking the caller's permissions.
get_goalGet goalGETReturns a saved goal of the website (name, description, the type and value it tracks) as Umami returns it; Umami's contract documents only ok, so the answer is passed through whole.
list_goalsList goalsGETReturns a paginated list of the saved goals for the website, optionally filtered by search text.

Pixel, 4 operations

create_pixelCreate pixelPOSTCreates a tracking pixel with a name and slug, optionally assigned to a team.
delete_pixelDelete pixelDELETEPermanently deletes a tracking pixel; it stops recording. Cannot be undone.
get_pixelGet pixelGETReturns the specified tracking pixel and its configuration.
list_pixelsList pixelsGETReturns a paginated list of the current user's tracking pixels, with search and sorting options.

Segment, 4 operations

create_segmentCreate segmentPOSTSaves a named segment or cohort with its type and filter parameters for the website.
delete_segmentDelete segmentDELETEDeletes the specified saved segment or cohort from the website.
get_segmentGet segmentGETReturns a saved segment or cohort and its filter parameters for the website.
list_segmentsList segmentsGETReturns saved segments or cohorts for the website, filtered by the requested type and search text.

Session series, 4 operations

get_session_array_seriesGet session array seriesGETCounts distinct sessions for individual values in an array property, grouped by value and time interval.
get_session_date_seriesGet session date seriesGETCounts distinct sessions by dates stored in the specified custom property, using the selected date range and filters.
get_session_numeric_seriesGet session numeric seriesGETReturns the sum, average, or count of a numeric session property, grouped by time interval for the selected date range and filters.
get_session_property_seriesGet session property seriesGETCounts distinct sessions for string values in a custom property, grouped by value and time interval.

Session stat, 4 operations

get_session_data_statsGet session data statsGETReturns session, visit, pageview, event, and total activity counts grouped by values of the specified session property.
get_session_numeric_statsGet session numeric statsGETReturns the total, average, median, minimum, and maximum of the specified numeric session property for the selected date range and filters.
get_session_statsGet session statsGETReturns aggregate session metrics for the website over the date range and filters, as Umami returns them (its contract does not list the fields, so the answer is passed through whole).
get_weekly_sessionsGet weekly sessionsGETReturns distinct visitor counts grouped by day of the week and hour, in the selected timezone and date range, as rows of numbers.

Team, 4 operations

create_teamCreate teamPOSTCreates a team owned by the current user (administrators may name another owner with ownerId). Umami generates the team's access code, which lets anyone join the team.
delete_teamDelete teamDELETEPermanently deletes a team. Cannot be undone.
get_teamGet teamGETReturns a team's id, name, logo, two-factor requirement and dates. The access code is not returned.
list_my_teamsList my teamsGETReturns a paginated list of teams the current user belongs to, with sorting options.

Team member, 4 operations

add_team_memberAdd team memberPOSTAdds an existing Umami user to a team with a role (the caller needs the right to manage members); gives that user access to the team's websites.
get_team_memberGet team memberGETReturns the specified user's membership details for a team.
join_teamJoin teamPOSTAdds the current user to a team as a member, using the team's access code.
list_team_membersList team membersGETReturns a paginated list of members of the specified team, including usernames and membership details.

Website, 4 operations

create_websiteCreate websitePOSTCreates a website with a name and domain, optionally assigning it to a team and creating a share.
delete_websiteDelete websiteDELETEPermanently deletes a website and its analytics data. Cannot be undone.
get_websiteGet websiteGETReturns the specified website's details and configuration.
list_my_websitesList my websitesGETReturns a paginated list of the current user's websites, optionally including websites accessible through team membership.

Event data, 3 operations

get_event_dataGet event dataGETReturns the custom property records, data types, and values attached to a specific event.
list_event_dataList event dataGETReturns a page of events in the selected date range, grouping each event's custom property records together.
list_event_data_pivotList event data pivotGETReturns a page of occurrences of the specified event, with event details and property keys and values grouped into one row per occurrence.

Event property, 3 operations

list_event_data_eventsList event data eventsGETReturns property names, types, and counts grouped by event name. When an event is specified, also groups by property value.
list_event_data_fieldsList event data fieldsGETReturns property names, data types, and counts for the selected date range, optionally restricted to an event name.
list_event_data_propertiesList event data propertiesGETReturns event names and their custom property names, data types, and record counts for the selected date range and filters.

Event stat, 3 operations

get_event_data_statsGet event data statsGETReturns counts of events with custom data, distinct property names, and property records for the selected date range and filters.
get_event_numeric_statsGet event numeric statsGETReturns the total, average, median, minimum, and maximum of the specified numeric event property for the selected date range and filters.
get_event_statsGet event statsGETReturns website event totals for the selected date range and filters, including totals for the comparison period.

Revenue, 3 operations

get_revenue_chartGet revenue chartGETReturns revenue chart data for the selected currency, date range, and website filters.
get_revenue_metricsGet revenue metricsGETReturns revenue grouped by the requested dimension, such as country or referrer, for the selected currency and date range.
get_revenue_statsGet revenue statsGETReturns revenue summary statistics for the selected currency and date range, with totals for the comparison period; Umami's contract describes only comparison, so the answer is passed through whole.

Web vital, 3 operations

get_performance_chartGet performance chartGETReturns p50, p75, and p95 values over time for a Core Web Vitals metric such as LCP, INP, CLS, FCP, or TTFB.
get_performance_metricsGet performance metricsGETRanks pages, titles, devices, or browsers by a Core Web Vitals metric, with p50, p75, and p95 values and a measurement count.
get_performance_statsGet performance statsGETReturns p50, p75, and p95 values for LCP, INP, CLS, FCP, and TTFB and the number of measurements in the date range.

Error issue, 2 operations

get_error_issueGet error issueGETReturns an error issue with its status, occurrence counts, and first and last seen times for the selected date range.
list_error_issuesList error issuesGETReturns a paginated list of error issues for the website, with occurrence and affected visit counts for the selected date range.

Error occurrence, 2 operations

get_error_occurrenceGet error occurrenceGETReturns a single occurrence of an error issue, including its stack trace, tags, and session details.
list_error_occurrencesList error occurrencesGETReturns a paginated list of occurrences for an error issue, newest first.

Error value, 2 operations

list_error_issue_valuesList error issue valuesGETReturns the distinct values and occurrence counts of an error field, such as release or browser, for one issue.
list_error_valuesList error valuesGETReturns the distinct values and occurrence counts of an error field, such as release or browser, across all issues.

Goal stat, 2 operations

get_goal_statsGet goal statsGETReturns the number of conversions and the total for an ad-hoc goal, given its type and value, over the selected date range.
get_saved_goal_statsGet saved goal statsGETReturns the number of conversions and the total for a saved goal over the selected date range, with optional filters.

Session, 2 operations

delete_sessionDelete sessionDELETEPermanently deletes a visitor session and its analytics data (for example on a data deletion request). Only on installs using a relational database alone. Cannot be undone.
get_sessionGet sessionGETReturns one visitor session: browser, OS, device, language, location, distinct ids, first and last activity and event count (visitor data), and whether the caller may delete it.

Session property, 2 operations

list_session_data_propertiesList session data propertiesGETReturns custom session property names, data types, and distinct session counts, optionally restricted to sessions with a selected property.
list_session_propertiesList session propertiesGETReturns custom property records, data types, and values for the specified website session.

Website metric, 2 operations

get_website_metricsGet website metricsGETReturns the most frequent values for a dimension such as pages, referrers, countries, browsers, campaigns, or events. Counts pageviews or events for activity dimensions and unique visitors for visitor dimensions.
get_website_metrics_expandedGet website metrics expandedGETReturns a ranked dimension (pass type, as get_website_metrics takes) with pageviews, visitors, visits, bounces and total time for each row, over the date range and filters.

Active visitor, 1 operation

get_active_visitorsGet active visitorsGETReturns the number of visitors active on the website in the last few minutes.

Attribution, 1 operation

get_attributionGet attributionGETAttributes conversions for a page path or custom event to referrers, paid ads, and UTM parameters using a first-click or last-click model.

Breakdown, 1 operation

get_breakdownGet breakdownGETReturns pageviews, visitors, visits, bounces, and total time for the website, grouped by the requested fields, over the date range.

Dashboard, 1 operation

get_dashboardGet dashboardGETReturns the current user's personal dashboard board and its configuration.

Date range, 1 operation

get_date_rangeGet date rangeGETReturns the earliest and latest recorded event dates for the website.

Error stat, 1 operation

get_error_statsGet error statsGETReturns the total number of error occurrences, issues, and affected visits for the selected date range, with a daily trend in UTC.

Event property value, 1 operation

list_event_data_valuesList event data valuesGETReturns values and their occurrence counts for a custom event property, optionally restricted by event name and data type.

Filter value, 1 operation

list_filter_valuesList filter valuesGETReturns the values available for a website filter (field such as browser, country or url path), and saved segments or cohorts when requested, to fill filter choices.

Funnel stat, 1 operation

get_saved_funnel_statsGet saved funnel statsGETReturns visitor counts and drop-off for each step of a saved funnel over the selected date range, with optional filters.

Heatmap, 1 operation

get_heatmapsGet heatmapsGETReturns click or scroll heatmap data for the website, optionally for a single page path, along with the pages that have recorded data.

Journey, 1 operation

get_journeysGet journeysGETReturns the most common paths visitors take through the website, between 2 and 7 steps long, with optional start and end steps.

Pageview series, 1 operation

get_pageviewsGet pageviewsGETReturns pageviews and sessions grouped by the requested time interval and timezone, including a comparison period when requested.

Pixel chart, 1 operation

get_pixel_chartsGet pixel chartsGETReturns visitor totals and chart data for the requested pixels the caller can view, within the selected date range.

Realtime activity, 1 operation

get_realtime_activityGet realtime activityGETReturns the last 30 minutes of a website's activity for the real-time view: totals, visitors and views series, countries, URLs, referrers and the latest events, filterable.

Recorder settings, 1 operation

get_recorder_settingsGet recorder settingsGETReturns public replay and heatmap settings, including sampling, masking, and duration limits. Returns disabled status when recording is unavailable.

Retention, 1 operation

get_retentionGet retentionGETReturns daily retention for the website: for each first-visit date, how many visitors returned on later days and the percentage.

Revenue session, 1 operation

list_revenue_sessionsList revenue sessionsGETReturns a paginated list of sessions with revenue in the selected currency and date range, applying website and search filters.

Session activity, 1 operation

get_session_activityGet session activityGETReturns activity for the specified session and sessions linked by visitor identity, using the requested date range and optional distinct ID.

Session data, 1 operation

list_session_data_pivotList session data pivotGETReturns a page of sessions matching the selected property and filters, with the latest property keys and values grouped into one row per session.

Session property value, 1 operation

list_session_data_valuesList session data valuesGETReturns custom session property values and their occurrence counts, optionally filtered by property name and data type.

Subscription, 1 operation

get_subscriptionGet subscriptionGETReturns subscription and feature availability for the current user or a specified team the user can access.

Tracked link chart, 1 operation

get_link_chartsGet link chartsGETReturns visitor totals and chart data for the requested links the caller can view, within the selected date range.

User, 1 operation

get_current_userGet current userGETReturns the user behind the credential: id, username, role and whether they are an administrator, plus the share context when called with a share token.

Utm metric, 1 operation

get_utm_metricsGet utm metricsGETReturns pageview counts grouped by a UTM parameter, such as source, medium, campaign, term, or content, for the selected date range.

Website chart, 1 operation

get_website_chartsGet website chartsGETReturns visitor totals and chart data for the requested websites the caller can view, within the selected date range.

Website stat, 1 operation

get_website_statsGet website statsGETReturns pageviews, unique visitors, visits, bounces, and total time on site for the selected date range and comparison period.

Showing the first 120 of 143 endpoints. The rest are in the product, searchable from the workflow builder and from chat.

Use Umami from Claude Code, Cursor or Codex

Connect Umami in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Umami operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Umami

Create your workspace
Sign up free. Nothing to install.
Connect Umami once
Add your Umami connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.