Attendee MCP

🚀 Attendee MCP Server

A Model Context Protocol (MCP) server for managing Attendee meeting bots. This server enables you to create, manage, and retrieve transcripts from meeting bots via Claude Desktop.

🚀 Quick Start

This MCP server requires a running Attendee backend service. Ensure you have the Attendee server set up and running before using this MCP server.

✨ Features

What can you do with this MCP?

1. You can send the bot to a meeting with "Send a bot to this meeting: <meeting_url>"
2. You can have the bot say something with "Have the bot say ", and it will say it in the meeting.
3. You can have the bot send a chat message with "Have the bot send a chat message: "
4. You can have the bot leave the meeting with "Have the bot leave the meeting"

To-Do List

• [x] Bot joins meeting
• [x] Bot leaves meeting
• [x] Get bot status
• [x] Send speech message (sends audio through the bot)
• [x] Send chat message
• [ ] Get list of active bots

🎯 What you can do with Claude using this MCP

Basic Bot Management

1. "Send a bot to this meeting: <meeting_url>" - Creates and sends an Attendee bot to join any meeting (Zoom, Google Meet, Teams)
2. "Get me the status of bot <bot_id>" - Returns current status, state, and transcription progress
3. "List all my active bots" - Shows all currently active meeting bots
4. "Remove bot <bot_id> from the meeting" - Makes the bot leave the meeting

Advanced Bot Features

5. "Make bot <bot_id> say 'Hello everyone!'" - Text-to-speech functionality
6. "Send chat message 'Hi there!' from bot <bot_id>" - Send chat messages through the bot
7. "Show this image in the meeting: <image_url> using bot <bot_id>" - Display images (Google Meet only)
8. "Play this video in the meeting: <video_url> using bot <bot_id>" - Play MP4 videos (Google Meet only)

Data Access

9. "Get the transcript from bot <bot_id>" - Retrieve meeting transcripts
10. "Get chat messages from bot <bot_id>" - Retrieve all chat messages from the meeting
11. "Get the recording from bot <bot_id>" - Get download URL for meeting recording
12. "Delete all data for bot <bot_id>" - Permanently delete recordings, transcripts, etc.

Combining MCPs

Combining MCPs leads to powerful workflows. For example, using the Brave Search MCP alongside the Attendee MCP. When you ask Claude, “Who won the last Roland Garros tournament?”, it:

1. Uses the web MCP to find the answer online.
2. Pipes the result to the Attendee bot, which speaks the answer back to you

📦 Installation

We will use Claude as an example, but you can use any tool that works with MCPs.

Clone the repository

# Clone your fork or the main repo
git clone https://github.com/rexposadas/attendee-mcp.git
cd attendee-mcp

# Install dependencies
npm install

# Build the TypeScript
npm run build

# Link for global use
npm link

🔧 Configuration

Environment Variables

Set these environment variables for your Attendee server:

export MEETING_BOT_API_URL="http://localhost:8000"  # Your Attendee server URL
export MEETING_BOT_API_KEY="your-api-key-here"     # Your Attendee API key

Add these to your shell profile (~/.zshrc, ~/.bashrc, etc.) to make them permanent.

Claude Desktop Configuration

Update your Claude Desktop configuration file at: ~/Library/Application Support/Claude/claude_desktop_config.json. After making the changes, restart Claude.

Adjust the mcpServers section to include the Attendee MCP server. Use the direct path for now since that's proving to be the most reliable.

{
  "mcpServers": {
    "attendee": {
      "command": "node",
      "args": [
        "<path>/attendee-mcp/dist/index.js"
      ],
      "env": {
        "MEETING_BOT_API_URL": "<attendee-url-here>",
        "MEETING_BOT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Replace /path/to/attendee-mcp with the actual path where you cloned the repository.

💻 Usage Examples

Once configured, you can use natural language commands in Claude Desktop:

Creating Meeting Bots

• "Create a meeting bot for this Zoom: https://zoom.us/j/123456789"
• "Send a bot to this Google Meet: https://meet.google.com/abc-defg-hij"
• "Join this Teams meeting with a bot: https://teams.microsoft.com/..."

Managing Bots

• "What's the status of bot bot_abc123?"
• "Show me all my active bots"
• "List all meeting bots"
• "Remove bot bot_abc123 from the meeting"

🔧 Technical Details

This server provides the following tools:

Core Bot Management

• create_meeting_bot - Create a bot to join and record a meeting
• get_bot_status - Check the current status of a meeting bot
• list_meeting_bots - List all active meeting bots
• remove_meeting_bot - Remove a bot from a meeting

Communication & Media

• make_bot_speak - Make the bot speak using text-to-speech
• send_chat_message - Send chat messages from the bot
• send_image_to_meeting - Display images through the bot (Google Meet only)
• send_video_to_meeting - Play videos through the bot (Google Meet only)

Data Retrieval

• get_meeting_transcript - Retrieve the meeting transcript
• get_chat_messages - Get chat messages from the meeting
• get_recording - Get the recording download URL
• delete_bot_data - Permanently delete all bot data

🐛 Troubleshooting

Common Issues

1. "Network error" or API connection issues:

   • Ensure your Attendee server is running on the configured URL
   • Check that your API key is correct
   • Verify the MEETING_BOT_API_URL and MEETING_BOT_API_KEY environment variables

2. MCP server not appearing in Claude Desktop:

   • Restart Claude Desktop completely after config changes
   • Check the Claude Desktop config file syntax is valid JSON
   • Look at Claude Desktop logs for error messages

3. "Method not allowed" errors:

   • Some API endpoints might not be fully implemented in your Attendee server
   • Check your Attendee server logs for more details

📄 License

MIT License - see LICENSE file for details.

🤝 Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b feature-name
3. Make your changes and test them
4. Commit your changes: git commit -m 'Add feature'
5. Push to the branch: git push origin feature-name
6. Submit a pull request

🔗 Related Projects

• Attendee - The main meeting bot service
• Model Context Protocol - The MCP specification and SDK

⚠️ Important Note

This MCP server requires a running Attendee backend service. Make sure you have the Attendee server set up and running before using this MCP server.