# Untappd

> Untappd is an open-source MCP server for food and drink. Untappd beer, brewery and venue data plus check-in feeds as 27 tools. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/darrenjrobinson/untappd-mcp-server
- **MCP Registry name:** io.github.darrenjrobinson/untappd
- **Categories:** [food and drink](https://ai-powered.com/categories/food-and-drink), [events and entertainment](https://ai-powered.com/categories/events-and-entertainment)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [Dostuff](https://ai-powered.com/mcp/dostuff): Dostuff is a freemium MCP server for events and entertainment.
- [Foodish](https://ai-powered.com/mcp/foodish): Foodish is a freemium MCP server for food and drink.
- [Eventbrite](https://ai-powered.com/mcp/eventbrite): Eventbrite is a freemium MCP server for events and entertainment.
- [Zovo Place Card Maker](https://ai-powered.com/mcp/zovo-place-card-maker): Zovo Place Card Maker is an MCP server for events and entertainment.
- [Sf Recpark](https://ai-powered.com/mcp/sf-recpark): Sf Recpark is a freemium MCP server for events and entertainment.
- [Menus Recommender](https://ai-powered.com/mcp/menus-recommender): Menus Recommender is an open-source MCP server for food and drink.
- [Madrid Events](https://ai-powered.com/mcp/madrid-events): Madrid Events is a freemium MCP server for events and entertainment.
- [Ticketmaster](https://ai-powered.com/mcp/ticketmaster): Ticketmaster is a freemium MCP server for events and entertainment.

---
Source: https://ai-powered.com/mcp/untappd
