Holaos
Turn repeat work into running AI work-streams.
What is Holaos?
Holaos is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to turn repeat work into running ai work-streams.
Turn repeat work into running AI work-streams.
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Turn repeat work into running AI work-streams.
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx holaosConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Holaos
HolaOS is an AI agent operating system built on Electron that turns repetitive knowledge work into autonomous AI work-streams. It provides a desktop environment for running multi-step AI agents with access to 1000+ OAuth integrations including GitHub, Slack, Linear, Jira, HubSpot, Gmail, and Notion, plus local file system access and multi-model support. Developers and teams use it to delegate recurring workflows — like triaging issues, drafting reports, or syncing data between tools — to continuously running AI agents.
Prerequisites
- Node.js 24.14.1 (exact version required by the project)
- npm installed alongside Node.js
- macOS (stable); Windows and Linux support is in progress
- An MCP-compatible client or the HolaOS desktop app itself
Install HolaOS via the one-line installer
Use the official install script to download and launch HolaOS in a single step. The --launch flag opens the application after installation completes.
curl -fsSL https://raw.githubusercontent.com/holaboss-ai/holaOS/refs/heads/main/scripts/install.sh | bash -s -- --launchOr clone and build from source
For development or customization, clone the repository, install dependencies, and start the desktop application manually.
git clone https://github.com/holaboss-ai/holaOS.git
cd holaOS
npm run desktop:installConfigure environment variables
Copy the example environment file and fill in your LLM provider API keys and any OAuth credentials needed for your integrations.
cp apps/desktop/.env.example apps/desktop/.envPrepare and launch the runtime
Build the runtime bundle and start the desktop development environment.
npm run desktop:prepare-runtime:local && npm run desktop:devConnect to your tools and define work-streams
Open the HolaOS UI, authenticate your integrations (GitHub, Slack, Notion, etc.) via OAuth, and configure your first AI work-stream that runs on a schedule or trigger.
Holaos Examples
Client configuration
MCP server configuration for integrating HolaOS with external MCP-compatible clients.
{
"mcpServers": {
"holaos": {
"command": "npx",
"args": ["holaos"]
}
}
}Prompts to try
Use HolaOS agents to automate multi-step workflows across connected tools.
- "Every morning, summarize all new GitHub issues from my repos and post a digest to Slack #dev-alerts"
- "When a Linear ticket is moved to 'Done', update the corresponding Notion page with the resolution notes"
- "Monitor my Gmail for invoices, extract the totals, and log them to a Google Sheet"
- "Triage new Jira tickets by priority and assign them to the appropriate team member based on their workload"Troubleshooting Holaos
Desktop app fails to start with Node.js version errors
HolaOS requires exactly Node.js 24.14.1. Use a version manager like nvm to install and switch to the correct version: 'nvm install 24.14.1 && nvm use 24.14.1'.
OAuth integrations fail to authenticate
Ensure your .env file has the correct OAuth client credentials for each integration. Check the apps/desktop/.env.example file for required variable names per integration, and verify your OAuth app has the correct redirect URI configured.
Work-streams stop running after system sleep
HolaOS runs as an Electron desktop app, so macOS may suspend it during sleep. Disable App Nap for HolaOS in macOS Activity Monitor, or use caffeinate to prevent sleep while agents are running.
Frequently Asked Questions about Holaos
What is Holaos?
Holaos is a Model Context Protocol (MCP) server that turn repeat work into running ai work-streams. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Holaos?
Follow the installation instructions on the Holaos GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Holaos?
Holaos works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Holaos free to use?
Yes, Holaos is open source and available under the NOASSERTION license. You can use it freely in both personal and commercial projects.
Holaos Alternatives — Similar Coding Agents Servers
Looking for alternatives to Holaos? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Holaos 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 Holaos?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.