Skales

v1.0.0Coding Agentsstable

Local-first AI desktop agent for Windows, macOS, Linux & Android. Codework, multi-agent teams, desktop automation, 15+ AI providers. No Docker. No terminal. AI Companion. Agent Skills (SKILL.md). Migration-Importer, BYOK, from 6 to 60+. Recurring Aut

agentic-aiai-agentai-assistantai-companionsandroid
Share:
1,096
Stars
0
Downloads
0
Weekly
0/5

What is Skales?

Skales is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to local-first ai desktop agent for windows, macos, linux & android. codework, multi-agent teams, desktop automation, 15+ ai providers. no docker. no terminal. ai companion. agent skills (skill.md). migr...

Local-first AI desktop agent for Windows, macOS, Linux & Android. Codework, multi-agent teams, desktop automation, 15+ AI providers. No Docker. No terminal. AI Companion. Agent Skills (SKILL.md). Migration-Importer, BYOK, from 6 to 60+. Recurring Aut

This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Local-first AI desktop agent for Windows, macOS, Linux & And

Use Cases

Local desktop AI agent with multi-LLM support
Codework and desktop automation tasks
skalesapp

Maintainer

LicenseNOASSERTION
Languagetypescript
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx skales

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Skales

Skales is a local-first AI desktop agent that runs on Windows, macOS, Linux, and Android, giving you a unified interface to 15+ AI providers including OpenAI, Anthropic, Google Gemini, Groq, DeepSeek, Mistral, and local models via Ollama or LM Studio. It exposes 139+ built-in tools spanning file operations, shell execution, browser automation, email, calendar, messaging platforms, code deployment, and desktop control—all without requiring Docker or a terminal. Developers and power users choose Skales to orchestrate multi-agent workflows, automate desktop tasks, and access community-published Agent Skills (SKILL.md) without leaving a single app.

Prerequisites

  • Windows, macOS, Linux, or Android device (desktop installer or APK from skales.app)
  • At least one AI provider API key (Anthropic, OpenAI, Google AI, Groq, etc.) or a local Ollama/LM Studio instance
  • Node.js 18+ if using the npx launcher
  • An MCP-compatible client (Claude Desktop, Cursor, etc.) if integrating via MCP
1

Download and install Skales

Visit skales.app and download the installer for your platform: a signed DMG for macOS, an EXE for Windows, a .deb package or AppImage for Linux, or the Google Play beta for Android. Run the installer and launch Skales.

npx skales
2

Configure your AI provider

Open Settings → AI Providers and enter your API key for the model you want to use. Skales supports OpenAI, Anthropic Claude, Google Gemini, Groq, DeepSeek, Mistral, xAI, Cerebras, OpenRouter, and local servers like Ollama, LM Studio, and KoboldCpp.

3

Set up web search (optional)

Go to Settings → Integrations → Web Search to enable DuckDuckGo (no key required), Brave Search, or a self-hosted SearXNG instance. This gives agents real-time web access.

4

Configure MCP integration

To use Skales as an MCP server with Claude Desktop or another client, add it to your MCP configuration file. Skales stores all data locally in ~/.skales-data.

{
  "mcpServers": {
    "skales": {
      "command": "npx",
      "args": ["skales"]
    }
  }
}
5

Browse and install Agent Skills

Open the Agent Skills browser inside Skales to discover 1000+ community-published SKILL.md skills. Install any skill to extend agent capabilities with pre-built workflows for coding, automation, CMS management, and more.

6

Create a multi-agent workflow

Use Skales Studio to wire multiple agents together using the Agent2Agent (A2A) delegation standard, assigning different AI providers or skill sets to each agent in your pipeline.

Skales Examples

Client configuration

Add Skales to your Claude Desktop MCP configuration to use it as an agent tool provider.

{
  "mcpServers": {
    "skales": {
      "command": "npx",
      "args": ["skales"]
    }
  }
}

Prompts to try

Once connected, use these prompts to explore Skales capabilities across its 139+ built-in tools.

- "Take a screenshot of my desktop and describe what's on screen"
- "Read all .ts files in ~/projects/myapp and summarize the architecture"
- "Send a Telegram message to my saved contact with today's task summary"
- "Clone the repo at github.com/example/project, run npm install, and deploy to Vercel"
- "Check my Google Calendar for tomorrow and draft a preparation email for each meeting"

Troubleshooting Skales

npx skales fails to launch or shows a version mismatch

Ensure Node.js 18+ is installed. Run `node --version` to verify. If npx caches an old version, clear it with `npx --yes skales` or download the native installer from skales.app for your platform.

AI provider returns authentication errors

Double-check your API key in Settings → AI Providers. Ensure the key has sufficient credits and that the selected model is available on your subscription tier. For local models (Ollama/LM Studio), confirm the server is running on the expected port.

Agent Skills are not appearing after installation

Restart the Skales app after installing a new skill. Skills are stored in ~/.skales-data and may require a reload to be picked up by the agent runtime. Check the skill's SKILL.md for any additional prerequisites.

Frequently Asked Questions about Skales

What is Skales?

Skales is a Model Context Protocol (MCP) server that local-first ai desktop agent for windows, macos, linux & android. codework, multi-agent teams, desktop automation, 15+ ai providers. no docker. no terminal. ai companion. agent skills (skill.md). migration-importer, byok, from 6 to 60+. recurring aut It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Skales?

Follow the installation instructions on the Skales GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Skales?

Skales works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Skales free to use?

Yes, Skales is open source and available under the NOASSERTION license. You can use it freely in both personal and commercial projects.

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.

Quick Config Preview

{ "mcpServers": { "skales": { "command": "npx", "args": ["-y", "skales"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Skales?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides