Scarf
Native macOS and iOS App for the Hermes AI agent — multi-window, multi-server (local + remote over SSH). Chat, dashboard, sessions, memory, cron, MCP, and more.
What is Scarf?
Scarf is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to native macos and ios app for the hermes ai agent — multi-window, multi-server (local + remote over ssh). chat, dashboard, sessions, memory, cron, mcp, and more.
Native macOS and iOS App for the Hermes AI agent — multi-window, multi-server (local + remote over SSH). Chat, dashboard, sessions, memory, cron, MCP, and more.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Native macOS and iOS App for the Hermes AI agent — multi-win
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx scarfConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Scarf
Scarf is a native macOS (and iOS companion via TestFlight) application that serves as a graphical front end for the Hermes AI agent, providing multi-window chat, real-time session monitoring, a visual MCP server registry with 30+ presets, credential management, cron job scheduling, and project dashboards. It connects to Hermes instances both locally and on remote machines via SSH, making it practical for developers who want a polished desktop experience for managing AI agents and their MCP server configurations without using a terminal.
Prerequisites
- macOS 14.6 (Sonoma) or later
- Hermes AI agent v0.6.0 or higher installed at ~/.hermes/ (v0.15.0+ recommended for full feature support)
- For remote server connections: SSH key access and sqlite3 available on the remote host
- Xcode 16.0+ only if building from source
Install Hermes AI agent
Scarf is a GUI front end for Hermes, so Hermes must be installed first. Follow the Hermes installation instructions to install the binary at ~/.hermes/ before launching Scarf.
# Verify Hermes is installed
ls ~/.hermes/
hermes --versionDownload and install Scarf
Download the latest Scarf release from GitHub. The Universal build supports both Apple Silicon and Intel Macs. Drag Scarf.app into your Applications folder.
# Download from GitHub Releases:
# https://github.com/awizemann/scarf/releases
# Choose Scarf-vX.X.X-Universal.zip
# If macOS quarantine blocks the app:
xattr -d com.apple.quarantine /Applications/Scarf.appLaunch Scarf and connect to your Hermes instance
Open Scarf.app from Applications. On first launch it will detect the local Hermes installation at ~/.hermes/ automatically. For remote instances, add a new server connection via the server management panel using your SSH key.
Add MCP servers via the registry
Navigate to Manage → MCP Servers in Scarf. Browse the 30+ curated presets (GitHub, Linear, Notion, Stripe, Sentry, etc.) or add a custom server by providing the stdio command and arguments or an HTTP URL with optional bearer authentication.
Start chatting and monitor sessions
Open a chat window to interact with the Hermes agent. The real-time dashboard shows system health, token usage, and cost tracking. Use the session browser to search past conversations and the activity feed to inspect tool execution logs.
Scarf Examples
Client configuration
Scarf manages MCP server configuration through its GUI rather than a JSON file. This is the underlying Hermes MCP configuration format that Scarf writes on your behalf when you add servers through the interface.
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "your-token"
}
},
"custom-server": {
"command": "/path/to/your/mcp-server",
"args": ["--port", "3000"]
}
}
}Prompts to try
After launching Scarf and connecting to Hermes, use these prompts in the chat window.
- "Show me the token usage and cost breakdown for my sessions this week."
- "List all MCP servers currently configured and their connection status."
- "Open a new chat session and help me debug the failing tests in my project."
- "Browse my Hermes skills and suggest which ones apply to a React project."
- "Set up a cron job to summarize my activity logs every morning at 9am."Troubleshooting Scarf
Scarf launches but shows 'Hermes not found' or cannot connect to local instance
Confirm Hermes is installed at ~/.hermes/ and the binary is executable. Run 'ls ~/.hermes/' and 'hermes --version' in your terminal. Scarf requires Hermes v0.6.0 minimum; upgrade to v0.15.0+ for full feature compatibility.
macOS Gatekeeper blocks Scarf from opening
Right-click Scarf.app and select Open, then click Open in the dialog. Alternatively remove the quarantine flag with: xattr -d com.apple.quarantine /Applications/Scarf.app. The app is Developer ID signed and notarized.
Remote SSH server connection fails to connect
Verify that your SSH key has access to the remote host and that sqlite3 and pgrep are installed on it. The remote machine must have a readable ~/.hermes/ directory. Test SSH connectivity manually with: ssh -i ~/.ssh/your_key user@hostname.
Frequently Asked Questions about Scarf
What is Scarf?
Scarf is a Model Context Protocol (MCP) server that native macos and ios app for the hermes ai agent — multi-window, multi-server (local + remote over ssh). chat, dashboard, sessions, memory, cron, mcp, and more. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Scarf?
Follow the installation instructions on the Scarf GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Scarf?
Scarf works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Scarf free to use?
Yes, Scarf is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Scarf Alternatives — Similar Developer Tools Servers
Looking for alternatives to Scarf? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Scarf 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 Scarf?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.