# Grassy Knees

> Grassy Knees is an open-source MCP server for events and entertainment. Source-checked kids' events, classes and places in 42 US metros, filtered by age and date. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://grassyknees.com
- **Repository:** https://github.com/grassyknees/grassyknees-mcp
- **MCP Registry name:** io.github.grassyknees/grassyknees-mcp
- **Categories:** [events and entertainment](https://ai-powered.com/categories/events-and-entertainment), [local services](https://ai-powered.com/categories/local-services)
- **Listing updated:** 2026-11-18

## About

This server answers questions like what to do with kids this weekend in Denver by returning listings from the Grassy Knees directory. The README says each listing was researched from the organizer's own page and carries a last-checked date. Every result gives what the listing is, where and when, ages and a link to its page, where price, registration and contact details live. A call returns at most 20 listings.

Search is per metro and can filter by when (today, tomorrow, this weekend, next 7 or 30 days) or explicit dates, by kind (event, program, place), free only, a child's age, category and keywords, with the soonest first. Dates use the metro's local time and this weekend means Friday to Sunday. A seasonal guide tool returns Halloween, Christmas lights, ice skating or Easter guides as Markdown trimmed to a character limit.

It makes read-only requests to public endpoints on grassyknees.com, caches responses for 10 minutes and sends no personal data. It needs Node.js 20 or later and no API key. Code is MIT; the listing data belongs to Grassy Knees and is meant for lookups rather than bulk copying.

## Features

- **Per-metro search:** Searches one of 42 US metros with filters for date window, age, kind, category, keywords and free only.
- **Listing detail:** Fetches schedule, upcoming dates, venue and ages for one listing by URL or id.
- **Seasonal guides:** Returns Halloween, Christmas, ice skating or Easter guides for a metro as trimmed Markdown.
- **Linked results:** Every result carries its grassyknees.com page URL for price and registration.
- **Read-only and cached:** Uses public endpoints only and caches responses in memory for 10 minutes.

## Good for

- Plan a weekend outing with children in a US city
- Find free activities for a 4-year-old this week
- Look up ice skating rinks near Chicago
- Find STEM events for a 10-year-old on Saturday
- Browse seasonal events such as pumpkin patches

## Install

### Claude Code (Terminal)

```sh
claude mcp add grassyknees-mcp -- npx -y grassyknees-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "grassyknees-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "grassyknees-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "grassyknees-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "grassyknees-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "grassyknees-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "grassyknees-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "grassyknees-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "grassyknees-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "grassyknees-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "grassyknees-mcp"
      ]
    }
  }
}
```

## Tools

- `list_metros`: Lists the 42 metro areas with the ids and page URLs used by other tools.
- `search_activities`: Searches one metro with date, kind, age, category, keyword and free-only filters, soonest first.
- `get_activity`: Returns schedule, upcoming dates, venue, ages and page URL for one listing.
- `seasonal_guide`: Returns a seasonal guide for a metro as Markdown trimmed to a maximum length.

## FAQ

### Does it need an API key?

No. It needs Node.js 20 or later and runs with npx -y grassyknees-mcp.

### How many cities are covered?

42 US metro areas, listed by the list_metros tool.

### How many results come back?

At most 20 per call, with a default of 10 for searches.

### Can I reuse the data in bulk?

The README says listing data belongs to Grassy Knees and is provided for lookups, not bulk copying.

### Is Grassy Knees free?

Yes. Grassy Knees is open source, so you can use and self-host it for free.

### How do I add Grassy Knees to Claude Code?

Run this command in your terminal: claude mcp add grassyknees-mcp -- npx -y grassyknees-mcp

### What are the best alternatives to Grassy Knees?

The closest alternatives to Grassy Knees are Dostuff, Eventbrite, Sf Recpark, Edmtrain and Nyc Parks.

## Where this comes from

- Description: written from the project's README and the project's website.
- 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.
- [Eventbrite](https://ai-powered.com/mcp/eventbrite): Eventbrite is a freemium 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.
- [Edmtrain](https://ai-powered.com/mcp/edmtrain): Edmtrain is a freemium MCP server for events and entertainment.
- [Nyc Parks](https://ai-powered.com/mcp/nyc-parks): Nyc Parks is a freemium MCP server for events and entertainment.
- [Countdowns Online MCP](https://ai-powered.com/mcp/countdowns-online-mcp-2): Countdowns Online MCP is an open-source 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.
- [Ticketmaster](https://ai-powered.com/mcp/ticketmaster): Ticketmaster is a freemium MCP server for events and entertainment.

---
Source: https://ai-powered.com/mcp/grassy-knees
