MCP ExplorerExplorer

Attendee Mcp

@rexposadason 13 days ago
1 MIT
FreeCommunity
AI Systems
MCP server for the Attendee Project

Overview

What is Attendee Mcp

The attendee-mcp is a Model Context Protocol (MCP) server designed for managing Attendee meeting bots, enabling users to create, manage, and retrieve transcripts from these bots during meetings.

Use cases

Use cases include automating meeting participation, enhancing communication through chat and speech, retrieving meeting transcripts for documentation, and displaying multimedia content during meetings.

How to use

To use attendee-mcp, you can send commands to the bot such as ‘Send a bot to this meeting: <meeting_url>’, ‘Have the bot say ’, or ‘Have the bot leave the meeting’. These commands allow for easy interaction with the meeting bots.

Key features

Key features include sending bots to meetings, managing bot status, sending speech and chat messages, retrieving transcripts, and displaying images and videos in meetings.

Where to use

attendee-mcp can be used in various online meeting platforms such as Zoom, Google Meet, and Microsoft Teams, making it versatile for different meeting environments.

Content

Attendee MCP Server

This is an MCP for sending and managing meeting bots with Attendee, an open-source meeting bot for recording and transcription. You can run Attendee locally or deploy it to the cloud.

Questions? Join the Attendee Slack.

Attendee Server MCP server

Quick Start: What can you do with this MCP?

Using Claude as an example: You can type the following and start working with an AI meeting bot.

  1. “Send a bot to this meeting: <meeting_url>”
  2. “Have the bot speak ‘Hello’”, and the bot would say ‘Hello’ it in the meeting.
  3. “Have the bot send a chat message: ‘Glad to be here’”, and the bot would write ‘Glad to be here’ in the chat.
  4. “Have the bot leave the meeting”

Claude Bot

Combining MCPs

Combining MCPs leads to powerful workflows. For example, I use the Brave Search MCP alongside the Attendee MCP. When I 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 me

🚀 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 you make 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.

🏃‍♂️ Quick Start if you want to run Attendee Locally.

  1. Start your Attendee server:
    make build
    make up
    
  2. Test in Claude Desktop:
    • Ask Claude: “What MCP tools are available?”

🎯 Usage Examples

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

Creating Meeting Bots

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”

🔧 Available MCP Tools

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


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.

Tools

No tools

Comments