Untappd

Name: Untappd
Author: darrenjrobinson

by darrenjrobinsonversion 2.1.0i★ –iRuns on your computer

Registry nameio.github.darrenjrobinson/untappd

Install

Overview

Description from the maker (original English)

MCP server exposing Untappd API tools for AI agents — full v4 read API coverage

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Other
You need to fill in: UNTAPPD_CLIENT_ID, UNTAPPD_CLIENT_SECRET, UNTAPPD_ACCESS_TOKEN

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: UNTAPPD_CLIENT_ID, UNTAPPD_CLIENT_SECRET, UNTAPPD_ACCESS_TOKEN, UNTAPPD_USERNAME, UNTAPPD_REDIRECT_URL, UNTAPPD_TOKEN_PATH

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "untappd": {
      "command": "npx",
      "args": [
        "-y",
        "untappd-mcp-server"
      ],
      "env": {
        "UNTAPPD_CLIENT_ID": "your-value",
        "UNTAPPD_CLIENT_SECRET": "your-value",
        "UNTAPPD_ACCESS_TOKEN": "your-value",
        "UNTAPPD_USERNAME": "your-value",
        "UNTAPPD_REDIRECT_URL": "your-value",
        "UNTAPPD_TOKEN_PATH": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add untappd --env UNTAPPD_CLIENT_ID=your-value --env UNTAPPD_CLIENT_SECRET=your-value --env UNTAPPD_ACCESS_TOKEN=your-value --env UNTAPPD_USERNAME=your-value --env UNTAPPD_REDIRECT_URL=your-value --env UNTAPPD_TOKEN_PATH=your-value -- npx -y untappd-mcp-server

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "untappd": {
      "command": "npx",
      "args": [
        "-y",
        "untappd-mcp-server"
      ],
      "env": {
        "UNTAPPD_CLIENT_ID": "your-value",
        "UNTAPPD_CLIENT_SECRET": "your-value",
        "UNTAPPD_ACCESS_TOKEN": "your-value",
        "UNTAPPD_USERNAME": "your-value",
        "UNTAPPD_REDIRECT_URL": "your-value",
        "UNTAPPD_TOKEN_PATH": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "untappd": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "untappd-mcp-server"
      ],
      "env": {
        "UNTAPPD_CLIENT_ID": "your-value",
        "UNTAPPD_CLIENT_SECRET": "your-value",
        "UNTAPPD_ACCESS_TOKEN": "your-value",
        "UNTAPPD_USERNAME": "your-value",
        "UNTAPPD_REDIRECT_URL": "your-value",
        "UNTAPPD_TOKEN_PATH": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

UNTAPPD_CLIENT_ID secret required env
Untappd API Client ID
UNTAPPD_CLIENT_SECRET secret required env
Untappd API Client Secret
UNTAPPD_ACCESS_TOKEN secret env
Untappd OAuth access token — unlocks the friend feed tool, user-scoped rate limits, and richer /user data. Optional: can instead be obtained interactively via the authenticate_untappd tool or `npx un…
UNTAPPD_USERNAME env
Default username for authenticated user tools
UNTAPPD_REDIRECT_URL env
OAuth redirect URL for interactive authentication — must exactly match the Callback URL registered in your Untappd app settings; default http://localhost:8737/callback
UNTAPPD_TOKEN_PATH env
Override path for the saved token file; default ~/.untappd-mcp-server/token.json

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account darrenjrobinson, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Otheri

More stars than 0% of the other 18333 servers in this category
Published to the registry more recently than 77% of the other 18333 servers in this category
Basic checks equal to or better than 100% of the other 18333 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Untappd safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: UNTAPPD_CLIENT_ID, UNTAPPD_CLIENT_SECRET, UNTAPPD_ACCESS_TOKEN

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (2.1.0) reached the registry 11 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: Spec Driven Development, Remote Desktop Commander, Signoff

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spec Driven Development

by formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Runs on your computer★ 440MITUpdated 14 months ago

Install

Remote Desktop Commander

by desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Runs in the cloud★ 211Updated 2 days ago

Install

Signoff

by ayuanxx-max

Five gates that make an agent's 'done' provable: run them, read the verdict, audit the record.

Runs on your computerUpdated today

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

untappd-mcp-server

A Model Context Protocol (MCP) server that exposes the Untappd API as tools for AI agents — 27 tools covering the full Untappd v4 read API, plus built-in interactive OAuth authentication. Search venues, breweries, and beers; check what's on tap via check-in feeds; explore user badges, friends, wish lists, and drinking history; and aggregate stats — all from any MCP-compatible client.

Prerequisites

Node.js 20+
Untappd API credentials (client_id and client_secret) from untappd.com/api
Optional: an Untappd OAuth access token to unlock authenticated tools — obtainable in-chat via the authenticate_untappd tool or npx untappd-mcp-server auth (see Interactive Authentication)

Quick Start

Via npx (zero install)

UNTAPPD_CLIENT_ID=xxx UNTAPPD_CLIENT_SECRET=yyy npx untappd-mcp-server

PowerShell

$env:UNTAPPD_CLIENT_ID = "your_client_id"

$env:UNTAPPD_CLIENT_SECRET = "your_client_secret" npx untappd-mcp-server

Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

"mcpServers": { "untappd": { "command": "npx", "args": ["untappd-mcp-server"], "env": { "UNTAPPD_CLIENT_ID": "your_client_id", "UNTAPPD_CLIENT_SECRET": "your_client_secret", "UNTAPPD_ACCESS_TOKEN": "optional_oauth_token", "UNTAPPD_USERNAME": "optional_default_username" } } } }

Tools

Tools marked 🔑 token require an access token (UNTAPPD_ACCESS_TOKEN env var or interactive authentication).

Authentication Tools

authenticate_untappd

Interactively authenticate with Untappd via OAuth: opens your browser to Untappd's approve page, captures the redirect on a temporary localhost listener, and saves the access token — the 🔑 tools work immediately, no restart. Prerequisite: your Untappd app's Callback URL must be set to exactly http://localhost:8737/callback (or your UNTAPPD_REDIRECT_URL).

Parameter	Type	Required	Description
`timeout_seconds`	integer	No	How long to wait for browser approval (default 180, max 600)

get_auth_status

Report authentication status: token presence, source (env var or token file), file path, and whether the 🔑 tools are unlocked. Free by default; validate: true verifies the token with one API call.

Parameter	Type	Required	Description
`validate`	boolean	No	Verify the token against the API with one call (default false)

Search & Lookup

venue_search

Search for venues (breweries, bars, restaurants) by name with optional location awareness.

Parameter	Type	Required	Description
`q`	string	Yes	Search query (venue name)
`lat`	number	No	Latitude for location-aware results
`lng`	number	No	Longitude for location-aware results

search_brewery

Search for breweries by name.

Parameter	Type	Required	Description
`q`	string	Yes	Brewery name search query
`offset`	integer	No	Offset for pagination

search_beer

Search for beers by name.

Parameter	Type	Required	Description
`q`	string	Yes	Beer name search query
`offset`	integer	No	Pagination offset
`sort`	string	No	Sort order: `checkin` (default), `name`, `count`

Venue

get_venue_info

Retrieve detailed information and recent check-ins for a venue.

Parameter	Type	Required	Description
`venue_id`	integer	Yes	Untappd venue ID
`compact`	boolean	No	If true, returns venue info only (no checkins, media, top beers)

get_venue_checkins

Retrieve the recent check-in feed for a venue. This is the primary tool for determining what's currently on tap — recent check-ins act as a live signal for available beers.

Parameter	Type	Required	Description
`venue_id`	integer	Yes	Untappd venue ID
`limit`	integer	No	Number of results (max 25, default 25)
`max_id`	integer	No	Return results older than this checkin ID
`min_id`	integer	No	Return only checkins newer than this ID

get_venue_foursquare_lookup

Resolve a Foursquare venue ID to its Untappd venue — the bridge between Foursquare/location data and Untappd venue tools.

Parameter	Type	Required	Description
`foursquare_id`	string	Yes	Foursquare venue ID in v2 MD5-hash format (v3 numeric IDs will not work)

Beer

get_beer_info

Retrieve detailed information for a specific beer.

Parameter	Type	Required	Description
`bid`	integer	Yes	Untappd beer ID
`compact`	boolean	No	If true, returns beer info only

get_beer_checkins

Retrieve the recent public check-in feed for a specific beer — what people are saying about it right now, and where they're drinking it.

Parameter	Type	Required	Description
`bid`	integer	Yes	Untappd beer ID
`limit`	integer	No	Results per page (max 50, default 25)
`max_id`	integer	No	Return results older than this checkin ID
`min_id`	integer	No	Return only checkins newer than this ID

get_trending_beers

Retrieve globally trending beers (macro and micro brew lists, by recent check-in velocity). No parameters.

Brewery

get_brewery_info

Retrieve detailed information, beer list, and recent check-ins for a brewery.

Parameter	Type	Required	Description
`brewery_id`	integer	Yes	Untappd brewery ID
`compact`	boolean	No	If true, returns brewery info only

get_brewery_checkins

Retrieve the recent public check-in feed for a brewery — all its beers being checked in globally.

Parameter	Type	Required	Description
`brewery_id`	integer	Yes	Untappd brewery ID
`limit`	integer	No	Results per page (max 50, default 25)
`max_id`	integer	No	Return results older than this checkin ID
`min_id`	integer	No	Return only checkins newer than this ID

User

get_user_info

Retrieve profile and stats for an Untappd user.

Parameter	Type	Required	Description
`username`	string	Yes	Untappd username
`compact`	boolean	No	If true, returns user info only (no checkins, media, recent brews)

get_user_activity

Retrieve the recent check-in activity feed for a user.

Parameter	Type	Required	Description
`username`	string	Yes	Untappd username
`limit`	integer	No	Number of results (max 25, default 25)
`max_id`	integer	No	Return results older than this checkin ID
`min_id`	integer	No	Return only checkins newer than this ID

get_user_distinct_beers

Retrieve the unique beers a user has checked in, with flexible sort ordering. sort=checkin with limit=1 is the single-call pattern for "most-checked-in beer".

Parameter	Type	Required	Description
`username`	string	Yes	Untappd username
`offset`	integer	No	Pagination offset
`limit`	integer	No	Results per page (max 50, default 25)
`sort`	string	No	`date` (default), `checkin`, `highest_rated`, `lowest_rated`, `highest_rated_you`, `lowest_rated_you`

get_user_wishlist

Retrieve beers on a user's wish list.

Parameter	Type	Required	Description
`username`	string	Yes	Untappd username
`offset`	integer	No	Pagination offset
`limit`	integer	No	Results per page (max 50, default 25)
`sort`	string	No	`date` (default), `checkin`, `highest_rated`, `lowest_rated`

get_user_badges

Retrieve a user's earned badges (pages of 50, most recent first).

Parameter	Type	Required	Description
`username`	string	Yes	Untappd username
`offset`	integer	No	Pagination offset (pages of 50)

get_user_friends

Retrieve a user's friend list (public accounts only).

Parameter	Type	Required	Description
`username`	string	Yes	Untappd username
`offset`	integer	No	Pagination offset
`limit`	integer	No	Results per page (max 50, default 25)

Activity Feeds

get_global_feed

Retrieve the global public check-in feed (The Pub). High rate-limit cost for the data returned — prefer min_id polling to fetch only new check-ins. Note: standard API keys are typically not authorized for /thepub — Untappd returns *"You are not authorized to call this method from this key"* unless your key has elevated access (get_local_feed is not restricted).

Parameter	Type	Required	Description
`limit`	integer	No	Results per page (max 50, default 25)
`max_id`	integer	No	Return results older than this checkin ID
`min_id`	integer	No	Return only checkins newer than this ID

get_local_feed

Retrieve the public check-in feed near a geographic point.

Parameter	Type	Required	Description
`lat`	number	Yes	Latitude
`lng`	number	Yes	Longitude
`radius`	integer	No	Radius in miles (default 25, max 50)
`limit`	integer	No	Results per page (max 50, default 25)
`max_id`	integer	No	Return results older than this checkin ID
`min_id`	integer	No	Return only checkins newer than this ID

get_friend_feed 🔑 token

Retrieve the friend check-in feed for the authenticated user.

Parameter	Type	Required	Description
`limit`	integer	No	Results per page (max 50, default 25)
`max_id`	integer	No	Return results older than this checkin ID
`min_id`	integer	No	Return only checkins newer than this ID

Checkin

get_checkin_info

Retrieve extended details for a specific check-in, including badges earned, toasts, and comments.

Parameter	Type	Required	Description
`checkin_id`	integer	Yes	Untappd check-in ID

Composite / Aggregation

These tools make multiple API calls (1 per page scanned — 50 beers/badges, 25 check-ins). They pre-check the remaining rate limit before starting and stop early — setting truncated: true in the response — if the budget runs low.

get_user_stats_at_venue

Get a user's check-in stats at a specific venue — visit count, last visit, average rating, top beers — by scanning their recent check-in feed. Untappd's API has no venue-history endpoint, so the stats cover the scanned window (max_pages × 25 check-ins), not all time.

Parameter	Type	Required	Description
`venue_id`	integer	Yes	Untappd venue ID
`username`	string	No	Untappd username (defaults to `UNTAPPD_USERNAME`)

| max_pages | intege

Only the beginning is shown; read the rest in the repo

Untappd

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Otheri

Common questions

Alternatives

Spec Driven Development

Remote Desktop Commander

Signoff

README from the maker

untappd-mcp-server

Prerequisites

Quick Start

Via npx (zero install)

PowerShell

Claude Desktop

Tools

Authentication Tools

authenticate_untappd

get_auth_status

Search & Lookup

venue_search

search_brewery

search_beer

Venue

get_venue_info

get_venue_checkins

get_venue_foursquare_lookup

Beer

get_beer_info

get_beer_checkins

get_trending_beers

Brewery

get_brewery_info

get_brewery_checkins

User

get_user_info

get_user_activity

get_user_distinct_beers

get_user_wishlist

get_user_badges

get_user_friends

Activity Feeds

get_global_feed

get_local_feed

get_friend_feed 🔑 token

Checkin

get_checkin_info

Composite / Aggregation

get_user_stats_at_venue