Untappd MCP server

untappd-mcp

An MCP server for Untappd. It talks to Untappd's mobile (v4) API using your own account — search beers, breweries, and venues; read profiles, check-ins, wishlists, distinct beers, badges, friends, and your friend activity feed; and post check-ins, toasts, and comments.

Developed and maintained by AI (Claude Code). Use at your own discretion. This

is an unofficial client that uses Untappd's private mobile API; it is not

affiliated with or endorsed by Untappd.

How it works

Untappd's iPad/iPhone app authenticates with a username/password xauth login (POST https://api.untappd.com/v4/xauth) that returns an access token, then calls the v4 API. This server reproduces that exactly:

credentials in the query), matching the app's real requests.

• Reads carry the token as an access_token query param.
• Writes carry it as an Authorization: Bearer header (with the app's client

The token is fetched on demand, cached in memory, and refreshed automatically if it goes stale.

Configuration

Copy .env.example to .env and fill it in for local use.

Obtaining the client id / secret

Untappd does not publish these; they live in the mobile app. Capture them from your own app's traffic with an HTTPS proxy:

certificate on the device running the Untappd app.

1. Install a proxy such as mitmproxy and trust its CA

system HTTP/HTTPS proxy) at the proxy.

1. Point the device (or, on an Apple-silicon Mac running the iPad app, the Mac's

request — its query string contains clientid and clientsecret.

1. Open Untappd and sign in. Find the POST https://api.untappd.com/v4/xauth

1. Put those into UNTAPPDCLIENTID / UNTAPPDCLIENTSECRET.

Keep these values private; do not commit them.

Tools

Reads: untappdsearchbeer, untappdbeerinfo, untappdbeeractivity, untappdsearchbrewery, untappdbreweryinfo, untappdbrewerybeers, untappdsearchvenue, untappdvenueinfo, untappdvenueactivity, untappduserinfo, untappdusercheckins, untappduserwishlist, untappduserbeers, untappduserbadges, untappduserfriends, untappdpendingfriends, untappdactivityfeed, untappdcheckininfo, untappdresolve, untappdopenurl, untappduservenues, untappdvenuebyfoursquare, untappdtrending, untappdnotifications, untappdlocalcheckins, untappd_healthcheck.

Writes (confirm-gated — return a dry-run preview unless called with confirm: true): untappdtoast, untappdaddcomment, untappddeletecomment, untappdcheckin, untappdwishlistadd, untappdwishlistremove, untappddeletecheckin, untappdaddfriend, untappdacceptfriend, untappdrejectfriend, untappdremovefriend.

Check-in cache: untappdsynccheckins, untappdsyncuserbeers, untappdcachehashad, untappdcachehashadmany, untappdcachenothad, untappdcachequery, untappdtopnothad.

Check-in cache

Shortened. The full README is on GitHub.