# Zenamu MCP by usefulapi

> Zenamu MCP by usefulapi is a freemium MCP server for productivity. Hosted MCP server connecting Zenamu studio schedules, clients and passes to AI assistants. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** Web, API, CLI, vscode
- **Website:** https://usefulapi.io/zenamu/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/zenamu
- **MCP Registry name:** io.usefulapi/zenamu
- **Categories:** productivity
- **Listing updated:** 2026-11-18

## About

The README describes this as a hosted connector, so there is nothing to install locally: you add the endpoint URL to Claude, ChatGPT, Cursor or another remote-MCP client and sign in with your own Zenamu public and secret API keys. Once connected, the assistant can read the class timetable, workshops, lecturers and locations, and look up client balances across entry-pass groups.

The server exposes 12 tools. Six are read-only listings. Two write tools add entry passes or credits to a single client and can be sent with an email notice; the page warns that retries are not idempotent, so balances should be checked first. The remaining four handle usage status, feature requests and Pro or Pro+ subscription changes through usefulapi.

The server is aimed at studio owners and front-desk staff who already run classes and client passes on Zenamu. The secret key is required for client data and pass group access, which needs the Zenamu Ultimate plan. usefulapi states it is independent and not affiliated with Zenamu.

## Features

- **Class schedule lookup:** Lists published classes and course sessions for a date range, including times, lecturers, places and canceled events.
- **Workshop and lecturer listing:** Returns public workshops with their own addresses and pricing, and maps lecturer IDs to names.
- **Client pass balances:** Shows active clients with credit and entry-pass balances, per pass group, and booking totals.
- **Grant passes or credits:** Adds entry passes or credits to one client, with an option to send the client an email.
- **OAuth sign-in:** Connects through a login page using Zenamu API keys, so no key goes into client config files.
- **Free tier with paid upgrades:** Free plan covers 50 tool calls per month; Pro and Pro+ raise the monthly cap for this server.

## Good for

- Check which classes are canceled or scheduled for next week
- Find clients whose entry-pass balance is running low
- Grant entry passes to a client after a purchase or make-good
- Look up which lecturers teach workshops this month
- Map class locations to addresses for front-desk staff

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http zenamu https://zenamu.usefulapi.io/mcp
```

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

```sh
https://zenamu.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "zenamu": {
      "url": "https://zenamu.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "zenamu": {
      "type": "http",
      "url": "https://zenamu.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "zenamu": {
      "serverUrl": "https://zenamu.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "zenamu": {
      "type": "http",
      "url": "https://zenamu.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `zenamu_list_classes`: List the published schedule of the studio for a date range (YYYY-MM-DD, studio time zone, max 366 days). Returns classes and course sessions (read eventType), with times, lecturerIds, locationId, pricing options and seat capacity when requested. Canceled events are included with isCanceled=true. Zenamu API: GET /v1/classes.
- `zenamu_list_workshops`: List the studio's public workshops (standalone events such as retreats and intensives) for a date range (YYYY-MM-DD, max 366 days). Each workshop has its own address and pricing. Canceled workshops are excluded. Zenamu API: GET /v1/workshops.
- `zenamu_list_lecturers`: List the studio's lecturers with name, photo and bio. Use it to turn the lecturerIds from classes and workshops into names. Contact details are never returned. Zenamu API: GET /v1/lecturers.
- `zenamu_list_places`: List the studio's physical locations with name and address. Use it to turn the locationId from classes into an address. Archived places are excluded. Zenamu API: GET /v1/places.
- `zenamu_list_clients`: List every active client of the studio with contact details, credit and entry-pass balances, pass balances per pass group, make-up sessions and booking totals. Returns personal data. Needs the secret key and the Ultimate plan. Archived and blocked clients are excluded. Zenamu API: GET /v1/clients.
- `zenamu_list_pass_groups`: List the studio's entry-pass groups (active and archived) with their id, name and state. Use an id as passGroupId when granting passes. Needs the secret key and the Ultimate plan. Zenamu API: GET /v1/pass-groups.
- `zenamu_grant_credits`: WRITE: adds credits to one client's account and returns the new balance. Changes what the client owes or holds. Not idempotent: a retry after an unclear failure can grant twice, so check the balance first with zenamu_list_clients. sendEmail=true emails the client. Zenamu API: POST /v1/clients/{clientId}/credits.
- `zenamu_grant_passes`: WRITE: adds entry passes to one client's account in a pass group and returns the new balance in that group. Changes what the client holds. Not idempotent: a retry after an unclear failure can grant twice, so check the balance first with zenamu_list_clients. Omit passGroupId for the studio's default group. sendEmail=true emails the client. Zenamu API: POST /v1/clients/{clientId}/passes.

## FAQ

### Is this an official Zenamu product?

No. usefulapi is an independent service and is not affiliated with or endorsed by Zenamu. The server calls the Zenamu API with your own access.

### Which AI clients can I use?

Any client that supports remote MCP servers over Streamable HTTP with OAuth login, including Claude, Claude Code, ChatGPT, Codex, Cursor, VS Code and Windsurf.

### What do I need to connect?

The login page asks for your Zenamu public API key (zen_pub_…) and secret API key (zen_live_…), which you find under Settings → General info → API keys in Zenamu admin.

### What does it cost?

The Free plan includes 50 tool calls per month. Pro is $9/mo or $90/yr with 10,000 calls, and Pro+ is $39/mo or $390/yr with 100,000 calls. Each plan covers this server only.

### Can the AI change my Zenamu data?

Yes, through two write tools that grant credits or entry passes. The other six tools are read-only, and most MCP clients ask for approval before a tool runs.

### Is Zenamu MCP by usefulapi free?

Zenamu MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Zenamu MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http zenamu https://zenamu.usefulapi.io/mcp

### What are the best alternatives to Zenamu MCP by usefulapi?

The closest alternatives to Zenamu MCP by usefulapi are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 13 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/zenamu-mcp-by-usefulapi
