@the-events-calendar/mcp-server
Advanced tools
An MCP (Model Context Protocol) server that provides unified CRUD operations for The Events Calendar and Event Tickets WordPress plugins.
tribe_events)tribe_venue)tribe_organizer)tribe_rsvp_tickets or tec_tc_ticket)Go to: Settings -> Cursor Settings -> MCP -> Add new global MCP server
Pasting the following configuration into your Cursor ~/.cursor/mcp.json file is the recommended approach. You may also install in a specific project by creating .cursor/mcp.json in your project folder. See Cursor MCP docs for more info.
Since Cursor 1.0, you can click the install button below for instant one-click installation.
{
"mcpServers": {
"tec-mcp": {
"command": "npx",
"args": [
"-y",
"@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
],
"env": {
"WP_APP_PASSWORD": "your-application-password"
}
}
}
}
Run this command. See Claude Code MCP docs for more info.
WP_APP_PASSWORD="your-application-password" claude mcp add tec-mcp -- npx -y @the-events-calendar/mcp-server --url https://your-wordpress-site.com --username your-username
Add this to your Windsurf MCP config file. See Windsurf MCP docs for more info.
{
"mcpServers": {
"tec-mcp": {
"command": "npx",
"args": [
"-y",
"@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
],
"env": {
"WP_APP_PASSWORD": "your-application-password"
}
}
}
}
Add this to your VS Code MCP config file. See VS Code MCP docs for more info.
"mcp": {
"servers": {
"tec-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
],
"env": {
"WP_APP_PASSWORD": "your-application-password"
}
}
}
}
It can be installed via Zed Extensions or you can add this to your Zed settings.json. See Zed Context Server docs for more info.
{
"context_servers": {
"TEC MCP": {
"command": {
"path": "npx",
"args": [
"-y",
"@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
]
},
"env": {"WP_APP_PASSWORD": "your-application-password"},
"settings": {}
}
}
}
To configure TEC MCP in Augment Code, you can use either the graphical interface or manual configuration.
Click the hamburger menu.
Select Settings.
Navigate to the Tools section.
Click the + Add MCP button.
Enter the following command:
WP_APP_PASSWORD="your-application-password" npx -y @the-events-calendar/mcp-server@latest --url https://your-wordpress-site.com --username your-username
Name the MCP: TEC MCP.
Click the Add button.
Once the MCP server is added, you can start using the TEC MCP tools directly within Augment Code.
mcpServers array in the augment.advanced object"augment.advanced": {
"mcpServers": [
{
"name": "tec-mcp",
"command": "npx",
"args": [
"-y",
"@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
],
"env": {"WP_APP_PASSWORD": "your-application-password"}
}
]
}
Once the MCP server is added, restart your editor. If you receive any errors, check the syntax to make sure closing brackets or commas are not missing.
Add this to your Roo Code MCP configuration file. See Roo Code MCP docs for more info.
{
"mcpServers": {
"tec-mcp": {
"command": "npx",
"args": [
"-y",
"@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
],
"env": {"WP_APP_PASSWORD": "your-application-password"}
}
}
}
See Gemini CLI Configuration for details.
~/.gemini/settings.json (where ~ is your home directory).mcpServers object in your settings.json file:{
"mcpServers": {
"tec-mcp": {
"command": "npx",
"args": [
"-y",
"@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
],
"env": {"WP_APP_PASSWORD": "your-application-password"}
}
}
}
If the mcpServers object does not exist, create it.
Open Claude Desktop and navigate to Settings > Connectors > Add Custom Connector. Enter the name as TEC MCP and configure it to launch via npx.
Open Claude Desktop developer settings and edit your claude_desktop_config.json file to add the following configuration. See Claude Desktop MCP docs for more info.
{
"mcpServers": {
"tec-mcp": {
"command": "npx",
"args": ["-y", "@the-events-calendar/mcp-server"]
}
}
}
Add this to your Opencode configuration file. See Opencode MCP docs docs for more info.
{
"mcp": {
"tec-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
],
"env": {"WP_APP_PASSWORD": "your-application-password"},
"enabled": true
}
}
}
See OpenAI Codex for more information.
Add the following configuration to your OpenAI Codex MCP server settings:
[mcp_servers.tec-mcp]
args = [
"-y",
"@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
]
command = "npx"
See JetBrains AI Assistant Documentation for more details.
Settings -> Tools -> AI Assistant -> Model Context Protocol (MCP)+ Add.Command in the top-left corner of the dialog and select the As JSON option from the listOK{
"mcpServers": {
"tec-mcp": {
"command": "npx",
"args": [
"-y",
"@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
],
"env": {"WP_APP_PASSWORD": "your-application-password"}
}
}
}
Apply to save changes.Settings -> Tools -> Junie -> MCP SettingsSee Kiro Model Context Protocol Documentation for details.
Kiro > MCP Servers+ Add button.{
"mcpServers": {
"TEC MCP": {
"command": "npx",
"args": [
"-y",
"@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
],
"env": {"WP_APP_PASSWORD": "your-application-password"},
"disabled": false,
"autoApprove": []
}
}
}
Save to apply the changes.Use the Add manually feature and fill in the JSON configuration information for that MCP server. For more details, visit the Trae documentation.
{
"mcpServers": {
"tec-mcp": {
"command": "npx",
"args": [
"-y",
"@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
],
"env": {"WP_APP_PASSWORD": "your-application-password"}
}
}
}
Use these alternatives to run the local TEC MCP server with other runtimes. These examples work for any client that supports launching a local MCP server via command + args.
{
"mcpServers": {
"tec-mcp": {
"command": "bunx",
"args": [
"-y",
"@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
],
"env": {"WP_APP_PASSWORD": "your-application-password"}
}
}
}
{
"mcpServers": {
"tec-mcp": {
"command": "deno",
"args": [
"run",
"--allow-env=NO_DEPRECATION,TRACE_DEPRECATION",
"--allow-net",
"npm:@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
],
"env": {"WP_APP_PASSWORD": "your-application-password"}
}
}
}
If you prefer to run the MCP server in a Docker container:
Build the Docker Image:
First, create a Dockerfile in the project root (or anywhere you prefer):
FROM node:18-alpine
WORKDIR /app
# Install the latest version globally
RUN npm install -g @the-events-calendar/mcp-server
# Expose default port if needed (optional, depends on MCP client interaction)
# EXPOSE 3000
# Default command to run the server
CMD ["mcp-server"]
Then, build the image using a tag (e.g., tec-mcp). Make sure Docker Desktop (or the Docker daemon) is running. Run the following command in the same directory where you saved the Dockerfile:
docker build -t tec-mcp .
Configure Your MCP Client:
Update your MCP client's configuration to use the Docker command.
Example for a cline_mcp_settings.json:
{
"mcpServers": {
"TEC MCP": {
"autoApprove": [],
"disabled": false,
"timeout": 60,
"command": "docker",
"args": ["run", "-i", "--rm", "tec-mcp"],
"transportType": "stdio"
}
}
}
Note: This is an example configuration. Please refer to the specific examples for your MCP client (like Cursor, VS Code, etc.) earlier in this README to adapt the structure (e.g., mcpServers vs servers). Also, ensure the image name in args matches the tag used during the docker build command.
The configuration on Windows is slightly different compared to Linux or macOS (Cline is used in the example). The same principle applies to other editors; refer to the configuration of command and args.
{
"mcpServers": {
"github.com/the-events-calendar/mcp-server": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
],
"env": {"WP_APP_PASSWORD": "your-application-password"},
"disabled": false,
"autoApprove": []
}
}
}
Add this to your Amazon Q Developer CLI configuration file. See Amazon Q Developer CLI docs for more details.
{
"mcpServers": {
"tec-mcp": {
"command": "npx",
"args": [
"-y",
"@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
],
"env": {"WP_APP_PASSWORD": "your-application-password"}
}
}
}
See Warp Model Context Protocol Documentation for details.
Settings > AI > Manage MCP servers.+ Add button.{
"TEC MCP": {
"command": "npx",
"args": [
"-y",
"@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
],
"env": {"WP_APP_PASSWORD": "your-application-password"},
"working_directory": null,
"start_on_launch": true
}
}
Save to apply the changes.Add the following configuration to the mcp section of your Copilot Coding Agent configuration file Repository->Settings->Copilot->Coding agent->MCP configuration:
{
"mcpServers": {
"tec-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
],
"env": {"WP_APP_PASSWORD": "your-application-password"}
}
}
}
For more information, see the official GitHub documentation.
See LM Studio MCP Support for more information.q
Program (right side) > Install > Edit mcp.json.{
"mcpServers": {
"TEC MCP": {
"command": "npx",
"args": [
"-y",
"@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
],
"env": {"WP_APP_PASSWORD": "your-application-password"}
}
}
}
Save to apply the changes.Program, or by clicking the plug icon at the bottom of the chat box.You can configure TEC MCP in Visual Studio 2022 by following the Visual Studio MCP Servers documentation.
Add this to your Visual Studio MCP config file (see the Visual Studio docs for details):
{
"mcp": {
"servers": {
"tec-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
],
"env": {"WP_APP_PASSWORD": "your-application-password"}
}
}
}
}
For more information and troubleshooting, refer to the Visual Studio MCP Servers documentation.
Add this to your Crush configuration file. See Crush MCP docs for more info.
{
"$schema": "https://charm.land/crush.json",
"mcp": {
"tec-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
],
"env": {"WP_APP_PASSWORD": "your-application-password"}
}
}
}
Open the "Settings" page of the app, navigate to "Plugins," and enter the following JSON:
{
"mcpServers": {
"tec-mcp": {
"command": "npx",
"args": [
"-y",
"@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
],
"env": {"WP_APP_PASSWORD": "your-application-password"}
}
}
}
Once saved, you can start using the TEC MCP tools. More information is available on BoltAI's Documentation site. For BoltAI on iOS, see this guide.
Edit your Rovo Dev CLI MCP config by running the command below -
acli rovodev mcp
Example config -
{
"mcpServers": {
"tec-mcp": {
"command": "npx",
"args": [
"-y",
"@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
],
"env": {"WP_APP_PASSWORD": "your-application-password"}
}
}
}
To configure TEC MCP in Zencoder, follow these steps:
{
"command": "npx",
"args": [
"-y",
"@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
],
"env": {
"WP_APP_PASSWORD": "your-application-password"
}
}
Once the MCP server is added, you can easily continue using it.
See Qodo Gen docs for more details.
{
"mcpServers": {
"tec-mcp": {
"command": "npx",
"args": [
"-y",
"@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
"--password",
"your-password"
]
}
}
}
See Local and Remote MCPs for Perplexity for more information.
Perplexity > SettingsConnectors.Add Connector.Advanced.TEC MCP{
"command": "npx"
"args": [
"-y",
"@the-events-calendar/mcp-server",
"--url",
"https://your-wordpress-site.com",
"--username",
"your-username"
],
"env": {
"WP_APP_PASSWORD": "your-application-password"
}
}
Save.| Option | Description |
|---|---|
--url <url> | WordPress site URL (required) |
--username <username> | WordPress username (required) |
--password <password> | WordPress application password (required) |
--ignore-ssl-errors | Ignore SSL certificate errors (for local development) |
--log-level <level> | Set logging level (error, warn, info, http, verbose, debug, silly) |
--log-file <path> | Write logs to file (suppresses console output for clean MCP protocol) |
--help, -h | Show help message |
tec-calendar-create-update-entitiesCreate or update a post. If an ID is provided, it updates; otherwise, it creates.
Parameters:
postType: "event" | "venue" | "organizer" | "ticket"id: (optional) Post ID for updatesdata: Post data object (fields depend on post type)Example - Create Event:
{
"postType": "event",
"data": {
"title": "My Event",
"start_date": "2024-12-25 10:00:00",
"end_date": "2024-12-25 18:00:00",
"venue": 123
}
}
Example - Create Event with Nested Venue:
{
"postType": "event",
"data": {
"title": "Conference 2024",
"start_date": "2024-12-25 10:00:00",
"end_date": "2024-12-25 18:00:00",
"venue": {
"venue": "Convention Center",
"address": "123 Main St",
"city": "New York",
"state_province": "NY",
"zip": "10001",
"country": "US"
}
}
}
tec-calendar-read-entitiesRead a single post by ID or list posts with filters.
Parameters:
postType: "event" | "venue" | "organizer" | "ticket"id: (optional) Post ID for single postquery: (optional) Search termpage: Page numberper_page: Items per page (max 100 by default)status: Post statusorder: "asc" | "desc"orderby: Field to order byinclude: Array of specific IDs to includeexclude: Array of specific IDs to excludeeventFilters: (optional) Event-specific filters
start_date: Events starting after this dateend_date: Events ending before this datevenue: Filter by venue IDorganizer: Filter by organizer IDExample - List Events:
{
"postType": "event",
"per_page": 10,
"status": "publish",
"eventFilters": {
"start_date": "2024-12-01",
"end_date": "2024-12-31"
}
}
Example - Search Events:
{
"postType": "event",
"query": "conference",
"per_page": 20
}
tec-calendar-delete-entitiesDelete a post (soft delete to trash or permanent delete).
Parameters:
postType: "event" | "venue" | "organizer" | "ticket"id: Post ID to deleteforce: (optional) true for permanent delete, false for trashExample:
{
"postType": "event",
"id": 123,
"force": false
}
git clone https://github.com/the-events-calendar/mcp-server.git
cd mcp-server
npm install
cp .env.example .env
.env with your credentials:WP_URL=https://your-wordpress-site.com
WP_USERNAME=your-username
WP_APP_PASSWORD=your-application-password
LOG_LEVEL=info
npm run dev
| Command | Description |
|---|---|
npm run dev | Run in watch mode with hot reload |
npm run build | Build TypeScript to JavaScript |
npm start | Run the compiled server |
npm run start:bun | Run with Bun runtime |
npm run start:debug | Run with debug logging |
| Variable | Description | Default |
|---|---|---|
WP_URL | WordPress site URL | Required |
WP_USERNAME | WordPress username | Required |
WP_APP_PASSWORD | Application password | Required |
WP_IGNORE_SSL_ERRORS | Ignore SSL errors | false |
WP_ENFORCE_PER_PAGE_LIMIT | Enforce 100 item limit | true |
MCP_SERVER_NAME | Server identifier | tec-mcp-server |
LOG_LEVEL | Logging verbosity | info |
LOG_FILE | Log output file | Console output |
By default, the API limits results to 100 items per page. To disable this limit:
WP_ENFORCE_PER_PAGE_LIMIT=false in your environmentper_page values in your requestsUse the simplified post type names:
eventvenueorganizerticketISC
FAQs
MCP server for The Events Calendar and Event Tickets
The npm package @the-events-calendar/mcp-server receives a total of 164 weekly downloads. As such, @the-events-calendar/mcp-server popularity was classified as not popular.
We found that @the-events-calendar/mcp-server demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Following last week’s supply chain attack, Nx published findings on the GitHub Actions exploit and moved npm publishing to Trusted Publishers.
Security News
AGENTS.md is a fast-growing open format giving AI coding agents a shared, predictable way to understand project setup, style, and workflows.
Security News
/Research
Malicious npm package impersonates Nodemailer and drains wallets by hijacking crypto transactions across multiple blockchains.