Roomey
Roomey is a multi-purpose Voice Agent designed to run your personal and business life.
What is Roomey?
Roomey is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to roomey is a multi-purpose voice agent designed to run your personal and business life.
Roomey is a multi-purpose Voice Agent designed to run your personal and business life.
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Roomey is a multi-purpose Voice Agent designed to run your p
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx roomey-ai-voice-agentConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Roomey
Roomey is an open-source, multi-purpose AI voice agent built on Python that handles personal and business tasks through natural speech. It integrates with Google Gemini for language understanding, supports smart home control, Google Calendar scheduling, real-time stock price lookups, LinkedIn post generation, web search, and maintains contextual memory across conversations. Roomey is designed for ultra-low latency voice interactions and runs locally on your machine, making it a Jarvis-style assistant that connects multiple productivity services through a single voice interface.
Prerequisites
- Python 3.9+ installed
- A Google Gemini API key (get one free at aistudio.google.com)
- A microphone and speakers for voice input/output
- Git to clone the repository
- Internet connection for Gemini API and integrated services (Calendar, stock data, web search)
Clone the repository
Clone the Roomey AI Voice Agent repository from GitHub to your local machine.
git clone https://github.com/augmentedstartups/Roomey_AI_Voice_Agent.git
cd Roomey_AI_Voice_AgentCreate and activate a virtual environment
Set up an isolated Python environment to avoid dependency conflicts with other projects.
python -m venv myenv
# macOS/Linux:
source myenv/bin/activate
# Windows:
myenv\Scripts\activateInstall dependencies
Install all required Python packages from the requirements file.
pip install -r requirements.txtConfigure environment variables
Create a .env file in the project root with your Gemini API key and an optional personalized system prompt. The PERSONALIZED_PROMPT field lets you give Roomey context about you (name, preferences, timezone, etc.).
GEMINI_API_KEY=your_gemini_api_key_here
PERSONALIZED_PROMPT=You are Roomey, my personal assistant. My name is Alex. I live in New York and work in finance.Launch Roomey
Start the voice agent. On macOS, use main_mac.py. Speak naturally to interact — Roomey processes speech in real time and responds with synthesized voice.
python main_mac.pyRoomey Examples
Client configuration
Example .env file configuration for Roomey with Gemini API key and personalization prompt.
{
"mcpServers": {
"roomey": {
"command": "python",
"args": ["/path/to/Roomey_AI_Voice_Agent/main_mac.py"],
"env": {
"GEMINI_API_KEY": "your_gemini_api_key_here",
"PERSONALIZED_PROMPT": "You are Roomey, my personal AI assistant."
}
}
}
}Prompts to try
Speak these requests to Roomey after it starts. It supports natural, conversational phrasing.
- "What's on my Google Calendar for tomorrow?"
- "Search the web for the latest news on renewable energy."
- "What is Apple's current stock price?"
- "Turn off the living room lights."
- "Write a LinkedIn post about my team's recent product launch."Troubleshooting Roomey
Gemini API key errors or authentication failure
Verify GEMINI_API_KEY is set correctly in your .env file and that the key is active in Google AI Studio (aistudio.google.com). Ensure the .env file is in the project root directory, not the virtual environment folder.
Microphone not detected or voice input not working
Check that your system microphone permissions are granted to Python/Terminal. On macOS, go to System Preferences → Privacy → Microphone and enable access. Test your mic with a simple recording app first.
High response latency
Roomey's latency depends on Gemini API response times and your network speed. Ensure you have a stable internet connection. Consider using a wired connection over Wi-Fi for more consistent latency.
Frequently Asked Questions about Roomey
What is Roomey?
Roomey is a Model Context Protocol (MCP) server that roomey is a multi-purpose voice agent designed to run your personal and business life. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Roomey?
Follow the installation instructions on the Roomey GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Roomey?
Roomey works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Roomey free to use?
Yes, Roomey is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Roomey Alternatives — Similar Communication Servers
Looking for alternatives to Roomey? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Roomey in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Roomey?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.