Skip to content
MCP server

Untappd

Untappd beer, brewery and venue data plus check-in feeds as 27 tools

Runs locallyStatus and history
Install
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-server

Add 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 IDRequired
  • UNTAPPD_CLIENT_SECRETUntappd API Client SecretRequired
  • UNTAPPD_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 tools
  • UNTAPPD_REDIRECT_URLOAuth redirect URL for interactive authentication — must exactly match the Callback URL registered in your Untappd app settings; default http://localhost:8737/callback
  • UNTAPPD_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.

How AIPoweredBot checks servers