# OpenAgenda

> OpenAgenda is an MCP server for events and entertainment. Let an AI assistant search, edit and moderate your OpenAgenda event agendas. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Platforms:** API, CLI
- **Website:** https://mcp.openagenda.com
- **Repository:** https://github.com/openagenda/oa-public
- **MCP Registry name:** com.openagenda/mcp
- **Categories:** [events and entertainment](https://ai-powered.com/categories/events-and-entertainment)
- **Listing updated:** 2026-11-14

## About

Rather than one tool per API call, this server hands the assistant two: one to search the OpenAgenda API documentation and one to execute a short JavaScript program written against the OpenAgenda SDK. Several API calls can sit in one program, which suits bulk work such as importing a spreadsheet of events.

The site's examples show listing a week of concerts in an agenda, creating 468 events from a spreadsheet and holding them for moderation with unmatched locations created and unmappable addresses reported, and publishing only events that have an image, a location and an upcoming date. Imported events keep the spreadsheet identifier so later updates do not duplicate them.

The hosted server at mcp.openagenda.com signs you in with your OpenAgenda account, so everything runs under your own permissions; publishing requires being a moderator or administrator of the agenda. An npm stdio package takes an API key instead, and offers a Node permission sandbox or a Deno executor with network limits.

## Features

- **Documentation search:** Finds the API operation and parameters that answer a question.
- **Code execution:** Runs short programs against the OpenAgenda SDK, with several calls per run.
- **Bulk event import:** Creates events from a spreadsheet and flags addresses that fail geocoding.
- **Moderation and publishing:** Publishes complete events and leaves incomplete ones for review, subject to your role.
- **Hosted or local:** Remote server with OAuth, or an npm stdio package with an API key.
- **Sandboxed executor:** Local runs use Node's permission sandbox or an optional Deno executor.

## Good for

- Find this week's events in a city agenda
- Import a spreadsheet of events for moderation
- Publish only events that have an image, location and date
- Review incomplete events and see what each one lacks

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://mcp.openagenda.com/mcp
```

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

```sh
https://mcp.openagenda.com/mcp
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.openagenda.com/mcp"
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.openagenda.com/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://mcp.openagenda.com/mcp
```

Enter a Name (for example "OpenAgenda"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

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

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

## Tools

- `search_docs`: Searches the OpenAgenda API documentation for the operation and parameters needed.
- `execute`: Runs a short JavaScript program with the OpenAgenda SDK under the user's permissions.

## FAQ

### How many tools does it expose?

Two: one searches the API documentation and one runs code, per the site.

### How does it sign in?

The hosted server uses your OpenAgenda account via OAuth; the npm package uses an OA_API_KEY.

### Can anyone publish events?

Publishing needs moderator or administrator rights on the agenda.

### Is the sandbox network-restricted?

With the default Node executor the network is not bounded; the Deno executor adds a scoped network boundary.

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

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

### What are the best alternatives to OpenAgenda?

The closest alternatives to OpenAgenda are Soundcheck, Agena: AI agent events in Europe, Events, What's Up In: local events and HaMitaperim · Tel Aviv tech meetups.

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

- [Soundcheck](https://ai-powered.com/mcp/soundcheck): Soundcheck is an MCP server for events and entertainment.
- [Agena: AI agent events in Europe](https://ai-powered.com/mcp/agena-ai-agent-events-in-europe): Agena: AI agent events in Europe is a freemium MCP server for events and entertainment.
- [Events](https://ai-powered.com/mcp/events-2): Events is a free MCP server for events and entertainment.
- [What's Up In: local events](https://ai-powered.com/mcp/what-s-up-in-local-events): What's Up In: local events is a free MCP server for events and entertainment.
- [HaMitaperim · Tel Aviv tech meetups](https://ai-powered.com/mcp/hamitaperim-tel-aviv-tech-meetups): HaMitaperim · Tel Aviv tech meetups is a free MCP server for events and entertainment.
- [FindLocal Events](https://ai-powered.com/mcp/findlocal-events): FindLocal Events is a freemium MCP server for events and entertainment.
- [Evntdsh](https://ai-powered.com/mcp/evntdsh): Evntdsh is a paid MCP server for events and entertainment.

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