Untappd
Untappd beer, brewery and venue data plus check-in feeds as 27 tools
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 2.1.0
- Listing updated
- today
Similar MCP servers
About Untappd
Untappd is an open-source MCP server for food and drink. It runs locally on your machine and is started by your AI client.
This server wraps the Untappd v4 read API in 27 tools for AI assistants. It can search beers, breweries and venues, fetch detailed records, read recent check-in feeds and show trending beers. Because check-ins are a live signal, the venue feed is the suggested way to see what is currently on tap. Foursquare venue IDs can be resolved to Untappd venues.
With your own Untappd API client ID and secret it runs read-only against public data. An optional OAuth token unlocks user-scoped tools such as the friend feed, badges, friends, wish lists and drinking history, plus higher rate limits. The token can come from an environment variable or an interactive browser sign-in through the authenticate_untappd tool, saved to a local token file.
It runs locally over stdio through npx and needs Node.js 20 or later. Results can be sorted and paginated, and a compact flag trims responses.
Install
Run in a terminal
claude mcp add untappd --env UNTAPPD_CLIENT_ID='<UNTAPPD_CLIENT_ID>' --env UNTAPPD_CLIENT_SECRET='<UNTAPPD_CLIENT_SECRET>' --env UNTAPPD_ACCESS_TOKEN='<UNTAPPD_ACCESS_TOKEN>' -- npx -y untappd-mcp-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"untappd": {
"command": "npx",
"args": [
"-y",
"untappd-mcp-server"
],
"env": {
"UNTAPPD_CLIENT_ID": "<UNTAPPD_CLIENT_ID>",
"UNTAPPD_CLIENT_SECRET": "<UNTAPPD_CLIENT_SECRET>",
"UNTAPPD_ACCESS_TOKEN": "<UNTAPPD_ACCESS_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"untappd": {
"command": "npx",
"args": [
"-y",
"untappd-mcp-server"
],
"env": {
"UNTAPPD_CLIENT_ID": "<UNTAPPD_CLIENT_ID>",
"UNTAPPD_CLIENT_SECRET": "<UNTAPPD_CLIENT_SECRET>",
"UNTAPPD_ACCESS_TOKEN": "<UNTAPPD_ACCESS_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"untappd": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"untappd-mcp-server"
],
"env": {
"UNTAPPD_CLIENT_ID": "<UNTAPPD_CLIENT_ID>",
"UNTAPPD_CLIENT_SECRET": "<UNTAPPD_CLIENT_SECRET>",
"UNTAPPD_ACCESS_TOKEN": "<UNTAPPD_ACCESS_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"untappd": {
"command": "npx",
"args": [
"-y",
"untappd-mcp-server"
],
"env": {
"UNTAPPD_CLIENT_ID": "<UNTAPPD_CLIENT_ID>",
"UNTAPPD_CLIENT_SECRET": "<UNTAPPD_CLIENT_SECRET>",
"UNTAPPD_ACCESS_TOKEN": "<UNTAPPD_ACCESS_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"untappd": {
"command": "npx",
"args": [
"-y",
"untappd-mcp-server"
],
"env": {
"UNTAPPD_CLIENT_ID": "<UNTAPPD_CLIENT_ID>",
"UNTAPPD_CLIENT_SECRET": "<UNTAPPD_CLIENT_SECRET>",
"UNTAPPD_ACCESS_TOKEN": "<UNTAPPD_ACCESS_TOKEN>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
UNTAPPD_CLIENT_IDUntappd API Client IDRequiredUNTAPPD_CLIENT_SECRETUntappd API Client SecretRequiredUNTAPPD_ACCESS_TOKENUntappd 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 untappd-mcp-server auth` (stored in ~/.untappd-mcp-server/token.json)UNTAPPD_USERNAMEDefault username for authenticated user toolsUNTAPPD_REDIRECT_URLOAuth redirect URL for interactive authentication — must exactly match the Callback URL registered in your Untappd app settings; default http://localhost:8737/callbackUNTAPPD_TOKEN_PATHOverride path for the saved token file; default ~/.untappd-mcp-server/token.json
Tools this server provides (16)
Taken from the project documentation; the running server may differ.
- authenticate_untappd
- Interactive OAuth sign-in that saves a token.
- get_auth_status
- Reports authentication status.
- venue_search
- Searches venues by name.
- search_brewery
- Searches breweries by name.
- search_beer
- Searches beers by name.
- get_venue_info
- Venue details and recent check-ins.
- get_venue_checkins
- Recent check-in feed for a venue.
- get_venue_foursquare_lookup
- Resolves a Foursquare ID to an Untappd venue.
- get_beer_info
- Details for a beer.
- get_beer_checkins
- Recent check-ins for a beer.
- get_trending_beers
- Globally trending beers.
- get_brewery_info
- Brewery details and beer list.
- get_brewery_checkins
- Recent check-ins for a brewery.
- get_user_info
- Profile and stats for a user.
- get_user_activity
- Recent activity feed for a user.
- get_user_distinct_beers
- Unique beers a user has checked in.
What it does
- Search tools
- Finds beers, breweries and venues by name.
- Check-in feeds
- Reads recent check-ins for venues, beers, breweries and users.
- Trending beers
- Lists globally trending macro and micro brews.
- Interactive OAuth
- Signs in through the browser and saves a token locally.
- User data
- Reads badges, friends, wish lists and distinct beers with a token.
- Compact responses
- A flag returns summary data only.
Good for
- Find what is likely on tap at a bar
- Look up a brewery's beer list
- Check what people say about a beer right now
- Find a user's most-checked-in beer
- Map a Foursquare venue to Untappd
Pricing
Open source
Open source; needs your own Untappd API credentials
Untappd FAQ
What credentials are needed?
An Untappd API client ID and secret; an access token is optional.
What does the token unlock?
The friend feed, richer user data and user-scoped rate limits.
What runtime is required?
Node.js 20 or later.
Does it write data?
It covers the read API only.
Is Untappd free?
Yes. Untappd is open source, so you can use and self-host it for free.
How do I add Untappd to Claude Code?
Run this command in your terminal: claude mcp add untappd --env UNTAPPD_CLIENT_ID='<UNTAPPD_CLIENT_ID>' --env UNTAPPD_CLIENT_SECRET='<UNTAPPD_CLIENT_SECRET>' --env UNTAPPD_ACCESS_TOKEN='<UNTAPPD_ACCESS_TOKEN>' -- npx -y untappd-mcp-server
What are the best alternatives to Untappd?
The closest alternatives to Untappd are Dostuff, Foodish, Eventbrite, Zovo Place Card Maker and Sf Recpark.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.
