eesmyal/otter-mcp-server

Otter.ai MCP Server

A Model Context Protocol (MCP) server that provides seamless integration between Claude Desktop and your Otter.ai account. Access, search, and manage your Otter.ai conversations directly through Claude with natural language commands.

✨ Features

• 🎯 List conversations - Browse all your Otter.ai recordings with detailed metadata
• 🔍 Search functionality - Find conversations by content across your entire library
• 📥 Download recordings - Get transcripts and audio in multiple formats (txt, pdf, mp3, docx, srt)
• 📁 Folder management - Organize and browse your conversation folders
• 🔍 Content search - Search within specific conversations for detailed information
• 🗑️ Trash management - Clean up unwanted recordings
• 👤 Account info - View your Otter.ai account details

🚀 Quick Start

Prerequisites

• Python 3.8 or higher
• Active Otter.ai account
• Claude Desktop application

Installation

1. Clone this repository

   git clone https://github.com/yourusername/otter-mcp-server.git
   cd otter-mcp-server
   

2. Set up Python environment

   python3 -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   

3. Install dependencies

   pip install mcp
   pip install git+https://github.com/gmchad/otterai-api.git
   

4. Configure credentials

   Create a .env file in the project root:

   OTTER_EMAIL=your-otter-email@example.com
   OTTER_PASSWORD=your-otter-password
   

   ⚠️ Important: If your Otter.ai account has two-factor authentication enabled, you'll need to temporarily disable it for the API to work.

5. Configure Claude Desktop

   Add the MCP server to your Claude Desktop configuration:

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

   {
     "mcpServers": {
       "otter-ai": {
         "command": "/absolute/path/to/your/venv/bin/python",
         "args": ["/absolute/path/to/your/otter_mcp_server.py"],
         "env": {
           "OTTER_EMAIL": "your-otter-email@example.com",
           "OTTER_PASSWORD": "your-otter-password"
         }
       }
     }
   }
   

6. Test the installation

   python test_mcp_integration.py
   

7. Restart Claude Desktop to load the MCP server

📖 Usage Examples

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

• "List my Otter.ai conversations"
• "Search my recordings for 'project meeting'"
• "Show me conversations in the 'Work' folder"
• "Download conversation ABC123 in PDF format"
• "Find action items in my latest recording"
• "Show my Otter.ai account information"

🛠️ Available Tools

🔧 Development

Project Structure

otter-mcp-server/
├── otter_mcp_server.py         # Main MCP server implementation
├── otter_mcp_setup.md          # Detailed setup guide
├── test_mcp_integration.py     # Integration tests
├── CLAUDE.md                   # Development guidance
├── .env                        # Environment variables (create this)
├── .gitignore                  # Git ignore rules
└── venv/                       # Python virtual environment

Running Tests

# Activate virtual environment
source venv/bin/activate

# Run integration tests
python test_mcp_integration.py

# Test individual components
python -c "from otter_mcp_server import get_otter_client; print('✓ Server ready')"

🔒 Security & Privacy

• Credentials: Never commit your actual Otter.ai credentials to version control
• Local Storage: Downloaded files are stored temporarily on your local system
• API Access: Uses unofficial Otter.ai API - functionality may change with Otter.ai updates
• 2FA: Two-factor authentication must be disabled for API access

⚠️ Limitations

• Built on unofficial Otter.ai API that could break with service updates
• Requires disabling 2FA on your Otter.ai account
• No direct conversation renaming support
• File downloads use temporary storage locations

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

📄 License

This project is licensed under the MIT License - see the file for details.

🙏 Acknowledgments

• Built using the MCP (Model Context Protocol) framework
• Integrates with otterai-api unofficial API
• Designed for use with Claude Desktop

📞 Support

If you encounter issues:

1. Check the for detailed instructions
2. Verify your credentials and 2FA settings
3. Run the integration tests to diagnose problems
4. Open an issue on GitHub with error details

Note: This is an unofficial integration and is not affiliated with or endorsed by Otter.ai or Anthropic.