npm package: @talkspresso/mcp-server
Description: Manage your Talkspresso business through Claude Code or any MCP-compatible AI assistant
Latest version: 1.7.2

# @talkspresso/mcp-server

Manage your Talkspresso business through Claude Code or any MCP-compatible AI assistant.

## What it does

This MCP server lets Talkspresso providers control their business through conversational AI. Check your schedule, manage bookings, update services, view earnings, and more without leaving your AI chat.

Perfect for creators, coaches, and consultants who want to manage their Talkspresso business hands-free.

## Quick setup

The fastest way to get started is the interactive setup wizard:

```bash
npx @talkspresso/mcp-server --setup
```

This will:
1. Create your account (or log in)
2. Generate an API key
3. Set up your profile
4. Create your first service
5. Configure your availability
6. Connect to Claude Desktop and/or Claude Code

No need to visit talkspresso.com. Everything happens in your terminal.

### Manual setup

If you prefer to configure manually:

#### 1. Get your API key

Go to [talkspresso.com/settings/api-keys](https://talkspresso.com/settings/api-keys) and generate a new API key.

#### 2. Configure your AI assistant

**For Claude Code** - Add to `~/.claude/mcp.json`:

```json
{
  "talkspresso": {
    "command": "npx",
    "args": ["-y", "@talkspresso/mcp-server"],
    "env": {
      "TALKSPRESSO_API_KEY": "tsp_your_key_here"
    }
  }
}
```

**For Claude Desktop** - Add to your config file:

macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
Windows: `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "talkspresso": {
      "command": "npx",
      "args": ["-y", "@talkspresso/mcp-server"],
      "env": {
        "TALKSPRESSO_API_KEY": "tsp_your_key_here"
      }
    }
  }
}
```

Then restart Claude.

## Available tools

### Appointments & Scheduling
- **list-appointments** - View upcoming or completed appointments
- **get-appointment** - Get details about a specific appointment
- **get-pending-bookings** - See bookings waiting for approval
- **approve-appointment** - Approve a pending booking
- **decline-appointment** - Decline a booking with optional reason
- **create-appointment** - Create and send a session invite
- **send-appointment-invite** - Send invite for a created appointment
- **cancel-appointment** - Cancel an appointment
- **reschedule-appointment** - Reschedule to a new date/time
- **check-availability** - Check open time slots for a date
- **get-schedule** - Quick view of your next 50 appointments

### Clients
- **list-clients** - View all clients with search
- **get-client** - Client details and booking history
- **get-session-history** - Rich session history with summaries
- **get-client-activity** - Emails, testimonials, engagement stats

### Services
- **list-services** - View all service offerings
- **create-service** - Create a new service
- **get-service** - Service details
- **update-service** - Update pricing, description, status
- **delete-service** - Remove a service
- **duplicate-service** - Copy an existing service
- **get-service-bookings** - See who booked a service

### Profile & Calendar
- **get-profile** - View your profile
- **update-profile** - Update title, bio, categories
- **get-calendar** - View availability settings
- **update-calendar** - Update timezone, hours, buffer time
- **get-booking-link** - Get a shareable booking link

### Earnings & Payments
- **get-earnings** - Transaction history
- **get-revenue-summary** - Monthly revenue snapshot
- **get-my-subscription** - Subscription plan details
- **get-payment-methods** - Saved payment methods
- **get-stripe-account-link** - Connect/manage Stripe
- **create-billing-portal-session** - Manage billing

### Recordings
- **list-recordings** - Browse past session recordings
- **get-recording** - Recording details with transcript
- **update-recording** - Update title, visibility
- **delete-recording** - Remove a recording
- **get-client-recordings** - Recordings with a specific client
- **get-recording-files** - Download individual recording files
- **create-product-from-recording** - Turn a recording into a product

### Products
- **list-products** - View digital products
- **create-product** - Create a new product
- **get-product** - Product details
- **update-product** - Update product info
- **delete-product** - Remove a product
- **get-product-analytics** - Product performance stats
- **list-product-purchases** - See all purchases
- **generate-product-details** - AI-generate product listing

### Testimonials
- **list-testimonials** - View client testimonials
- **create-testimonial** - Add a testimonial manually
- **request-testimonial** - Email a client for a testimonial
- **approve-testimonial** / **reject-testimonial** - Moderate testimonials
- **toggle-featured-testimonial** - Feature/unfeature

### Promo Codes
- **list-promo-codes** - View all promo codes
- **create-promo-code** - Create a discount code
- **update-promo-code** / **delete-promo-code** - Manage codes
- **toggle-promo-code-active** - Enable/disable
- **get-promo-code-analytics** - Promo performance

### Messaging
- **list-conversations** - View all client conversations
- **get-conversation-messages** - Read messages
- **send-message** - Reply to a client
- **get-unread-message-count** - Check unread count

### Notifications
- **list-notifications** - View all notifications
- **mark-notification-read** / **mark-all-notifications-read**

### Live Sessions
- **start-live-session** - Go live with a shareable link
- **get-active-live-session** - Check if you're live
- **end-live-session** - End your live session
- **get-live-session-history** - Past live sessions
- **send-live-session-invite** - Invite someone to your live

### Organizations
- **list-my-organizations** - Your org memberships
- **get-organization** / **get-organization-members** / **get-organization-stats**
- **update-organization** - Update org settings
- **add-organization-member** / **send-organization-invitation**

### Brew AI Mentor
- **get-brew-status** - Check Brew status
- **start-brew-conversation** - Start chatting with Brew
- **send-brew-message** - Get business advice
- **get-brew-insights** - Proactive coaching
- **set-brew-goal** - Set a business goal

## Environment variables

| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `TALKSPRESSO_API_KEY` | Yes | - | Your API key |
| `TALKSPRESSO_API_URL` | No | `https://api.talkspresso.com` | API base URL |

## Example conversations

- "Show me my appointments for today"
- "Who are my top clients?"
- "Create a new 30-minute coaching call for $100"
- "What are my total earnings this month?"
- "Approve all pending bookings"
- "Connect my Stripe account"
- "Get my booking link so I can share it"
- "Set my availability to weekdays 9-5"

## Troubleshooting

**"TALKSPRESSO_API_KEY environment variable is required"**
Run `npx @talkspresso/mcp-server --setup` to set up your API key, or add it manually to your config.

**"API request failed"**
Check that your API key is valid. You can generate a new one at [talkspresso.com/settings/api-keys](https://talkspresso.com/settings/api-keys).

**Tools not showing up**
Restart Claude after adding the config. Make sure the JSON is valid (no trailing commas).

## Support

Questions? Email [support@talkspresso.com](mailto:support@talkspresso.com)

## License

MIT