Connect an MCP Server to Kotae

We recommend using Activepieces as an MCP server. It’s free to start and the UX is simpler than other MCP server (e.g., n8n)

What you’ll need

• Kotae.ai workspace with access to Developer → MCP
• An Activepieces account (a free plan works!)

For the specific example flow below, you will also need

• A Google account with Calendar access

Part 1 — Build the MCP tool in Activepieces

Step 1: Create a New Flow

In Activepieces, click New Flow. You can start from scratch, or use the ready-made Kotae shared template for booking a Google Calendar meeting:

This template covers everything you’ll do in Part 1, though you’ll still need to finish Parts 2 and 3 in Kotae. Once opened, name your flow something like Demo Call Guide.

Step 2: Add the MCP Tool

For your first step in the flow, choose MCP Tool.

Give it a clear name and description, such as:

• Name: Book a demo
• Description: Tool used to book or schedule a call with the business owner
• Parameters: Define the parameters Kotae will send:
• attendee_name (string, required)
• attendee_email (string, required)
• start_iso (string, required)
• end_iso (string, required)
• timezone (string, required, e.g. JST)

💡 Tip: Click “Generate Sample Data” to test your flow without connecting Kotae yet.

Step 3: Add the Google Calendar Step

Next, add another step: Google Calendar → Create Event.

Connect your Google account (you’ll only need to do this once), then choose the calendar where meeting invites should appear.

Fill in the fields like this:

• Summary/Title: Demo call with {{step_1.attendee_name}}
• Start: {{step_1.start_iso}}
• End: {{step_1.end_iso}}
• Guests/Attendees: {{step_1.attendee_email}}

You can also include an optional description:

• Requested by: {{step_1.attendee_name}} ({{step_1.attendee_email}})
• Timezone: {{step_1.timezone}}
  

Finally, turn on Send Notifications so guests receive their invitations automatically.

Step 4: Return a Reply to the MCP Client

Now add one final step: MCP → Reply to MCP Client.

This is what sends a response back to Kotae confirming that the booking worked. Use a payload like this:

{
"status": "success",
"message": "Booked! Calendar invite sent to {{step_1.attendee_email}}.",
"event": { "id": "{{step_2.id}}",
"htmlLink": "{{step_2.htmlLink}}",
"start": "{{step_2.start}}",
"end": "{{step_2.end}}"
}
}

Step 5: Test and Publish

Click Test and use sample values such as:

start_iso: 2025-09-12T15:00:00-07:00 and end_iso: 2025-09-12T15:30:00-07:00.

If the test looks good, click Publish. After publishing, copy your MCP Server URL and note the Auth header / API key — you’ll need these in Kotae.

Part 2 — Connect the MCP server in Kotae

Step 6: Open MCP Settings in Kotae

In your Kotae dashboard, go to Developer → MCP and click Add MCP Server. Give it a name like “Activepieces – Book a Demo”.

For the Event Type, choose Chatbot. This tells Kotae which kind of event will trigger your MCP flow.

Step 7: Paste the MCP JSON Configuration

In Activepieces, locate your MCP Server URL under Project → MCP → Connect → Other. Copy that full URL.

Then, back in Kotae, paste the configuration below, replacing [replace] with your URL:

{ "mcpServers":

{ "Activepieces": { "url": "[replace]" } }

}

Part 3 — End-to-End Test

Step 8: Try It in Your Chat

Open your Kotae chatbot and say something like:

“I’d like a meeting on Sep 12 at 3pm JST. My email is nicha@example.com.”

Kotae sends a request to your MCP server that looks like this:

{
"attendee_name": "Nicha",
"attendee_email": "[nicha@example.com](<mailto:nicha@example.com>)",
"start_iso": "2025-09-12T15:00:00-07:00",
"end_iso": "2025-09-12T15:30:00-07:00",
"timezone": "JST"
}

Activepieces creates the calendar event and replies with the JSON you defined earlier. Kotae then confirms the booking in chat:

“All set for Sep 12, 3:00–3:30 PM PT. I’ve sent you a calendar invite!”

Still Need Help?

If your test doesn’t work right away, double-check your MCP URL and API key, and make sure the Event Type in Kotae matches what you used in your Activepieces flow. You can also try running the flow manually inside Activepieces to confirm it’s working independently.

If you’re still stuck, reach out to Kotae Support — we’ll help you troubleshoot and get your integration running smoothly.