OpenAgenda
Let an AI assistant search, edit and moderate your OpenAgenda event agendas
- Platforms
- API, CLI
- Runs
- Locally or Remotely
- Version
- 1.6.0
- Listing updated
- 5 days ago
Similar MCP servers
About OpenAgenda
OpenAgenda is an MCP server for events and entertainment. It can run locally on your machine or as a hosted remote server.
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.
Install
Run in a terminal
claude mcp add --transport http mcp https://mcp.openagenda.com/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.openagenda.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.openagenda.com/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.openagenda.com/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp": {
"serverUrl": "https://mcp.openagenda.com/mcp"
}
}
}Add to Grok Bot desktop app → Connect apps → Add a custom connector
https://mcp.openagenda.com/mcpEnter a Name (for example "OpenAgenda"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.
Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp": {
"type": "http",
"url": "https://mcp.openagenda.com/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
OA_API_KEYOpenAgenda API key (the stdio credential — a least-privilege/read key is advised). The hosted remote uses OAuth instead.RequiredOA_BASE_URLv3 API base URL (defaults to https://api.openagenda.com/v3).OA_EXECUTORCode engine: node (default — Node's permission sandbox: no filesystem/subprocess; network NOT bounded) or deno (adds a scoped network egress boundary; recommended hardening, needs deno installed).OA_LOCAL_NO_SANDBOXDisable the Node permission sandbox entirely (bare node, NO boundary at all) — trusted/dev use only.
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- 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.
What it does
- 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
Pricing
Pricing unknown
Prices not published
Prices change. Check mcp.openagenda.com before you buy.
OpenAgenda 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.
