# Openagenda

> Openagenda is a freemium MCP server for maps and travel. MCP server for searching OpenAgenda public event calendars and listing their events. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted, Web
- **Website:** https://pipeworx.io/packs/openagenda
- **Repository:** https://github.com/pipeworx-io/mcp-openagenda
- **MCP Registry name:** io.github.pipeworx-io/openagenda
- **Categories:** [maps and travel](https://ai-powered.com/categories/maps-and-travel)
- **Listing updated:** 2026-11-18

## About

The server gives an AI client two lookups against OpenAgenda, the platform where cities, venues, tourism boards and organisations publish their event calendars. A client first searches agendas by keyword, such as a city, venue or festival name, and receives each agenda's identifier, slug and title. It then passes that identifier to a second tool that lists the agenda's events, defaulting to upcoming dates and optionally narrowing by keyword and date window.

Results include event title, dates, venue, coordinates and keywords, with English keywords used where the calendar provides them and French otherwise. Most agendas are French, so searches in French tend to return the most results. The README notes that the hosted endpoint also lists shared gateway meta-tools such as ask_pipeworx alongside these two.

The server is aimed at developers and assistant users who want event lookups inside an MCP client. Access runs through the Pipeworx gateway, which allows anonymous calls capped per day and a free key for a higher cap. The README describes it as an independent, unofficial integration.

## Features

- **Agenda keyword search:** Finds OpenAgenda event calendars by city, venue, festival or organisation name.
- **Event listing by agenda:** Lists events for a chosen agenda, defaulting to upcoming dates.
- **Date and keyword filters:** Narrows event results by keyword and by a date window.
- **Venue and coordinates:** Returns venue details and coordinates with each event.
- **Multiple transports:** Runs over streamable HTTP or locally via stdio through an npm package.

## Good for

- Find upcoming cultural events in a specific French city
- Build an assistant that answers what is on at a given venue or festival
- Pull event listings with coordinates for a local events map
- Check what a tourism board or organisation has scheduled in a date window

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http openagenda https://gateway.pipeworx.io/openagenda/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/openagenda/mcp
```

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

```json
{
  "mcpServers": {
    "openagenda": {
      "url": "https://gateway.pipeworx.io/openagenda/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "openagenda": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/openagenda/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "openagenda": {
      "serverUrl": "https://gateway.pipeworx.io/openagenda/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "openagenda": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/openagenda/mcp"
    }
  }
}
```

## Tools

- `search_agendas`: Find OpenAgenda agendas by keyword, returning uid, slug and title.
- `events`: List events from one agenda, with optional keyword and date filters.

## FAQ

### Does it need an API key?

Calls work anonymously but are capped per day. The README says a free Pipeworx key raises the cap, and the npm version reads it from the PIPEWORX_API_KEY variable.

### What does the events tool return?

According to the README, it returns title, dates, venue, coordinates and keywords, using English keywords where available and French otherwise.

### Which agendas are covered?

The product page describes agendas published by cities, cultural venues, tourism boards and organisations, mostly across France with some international ones.

### Is it affiliated with OpenAgenda?

No. The README states it is an independent, unofficial integration not endorsed by the upstream provider.

### Is Openagenda free?

Openagenda has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Openagenda to Claude Code?

Run this command in your terminal: claude mcp add --transport http openagenda https://gateway.pipeworx.io/openagenda/mcp

### What are the best alternatives to Openagenda?

The closest alternatives to Openagenda are Montreal Events, Paris Events, Helsinki Events, HiChinaTour Events and Funcheap.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Montreal Events](https://ai-powered.com/mcp/montreal-events): Montreal Events is a freemium MCP server for maps and travel.
- [Paris Events](https://ai-powered.com/mcp/paris-events): Paris Events is a freemium MCP server for maps and travel.
- [Helsinki Events](https://ai-powered.com/mcp/helsinki-events): Helsinki Events is a freemium MCP server for maps and travel.
- [HiChinaTour Events](https://ai-powered.com/mcp/hichinatour-events): HiChinaTour Events is an open-source MCP server for maps and travel.
- [Funcheap](https://ai-powered.com/mcp/funcheap): Funcheap is a freemium MCP server for maps and travel.
- [Openholidays](https://ai-powered.com/mcp/openholidays): Openholidays is a freemium MCP server for maps and travel.
- [C'est Chaud à Paris](https://ai-powered.com/mcp/c-est-chaud-a-paris): C'est Chaud à Paris is a free MCP server for maps and travel.
- [FeedIRL](https://ai-powered.com/mcp/feedirl): FeedIRL is an MCP server for maps and travel.

---
Source: https://ai-powered.com/mcp/openagenda-2
