Agent

v1.0.0Coding Agentsstable

Agent! Is a native macOS App that works with any LLM [local and cloud], [open source and paid] Claude, OpenAI, Gemini, Ollama, Qwen, Hugging Face, and 12 more. Writes code, builds Xcode projects, bump versions, manages git, automates Safari (AppleScr

accessibilityagentic-frameworkagentic-workflowaiai-agent
Share:
440
Stars
0
Downloads
0
Weekly
0/5

What is Agent?

Agent is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to agent! is a native macos app that works with any llm [local and cloud], [open source and paid] claude, openai, gemini, ollama, qwen, hugging face, and 12 more. writes code, builds xcode projects, bump...

Agent! Is a native macOS App that works with any LLM [local and cloud], [open source and paid] Claude, OpenAI, Gemini, Ollama, Qwen, Hugging Face, and 12 more. Writes code, builds Xcode projects, bump versions, manages git, automates Safari (AppleScr

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

Features

  • Agent! Is a native macOS App that works with any LLM [local

Use Cases

Native macOS LLM integration
Xcode project management
Git and Safari automation
macOS26

Maintainer

LicenseMIT
Languageswift
Versionv1.0.0
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y agent-server

Manual Installation

npx -y agent-server

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 Agent

Agent! is a native macOS application that acts as a powerful local AI coding and automation agent, supporting 18 LLM providers — including Claude, OpenAI, Gemini, Ollama, Qwen, and Apple Intelligence — and exposing them through an npm-distributed MCP server package. It can write and run code, build Xcode projects, manage git workflows, automate Safari with AppleScript and Selenium, send iMessages, spawn up to three concurrent sub-agents, and execute shell commands with full or privileged access. Teams and individual developers on Apple Silicon use it as an all-in-one AI assistant that stays entirely on-device for local models while seamlessly falling back to cloud providers.

Prerequisites

  • macOS (Apple Silicon required for local models; any modern Mac for cloud providers)
  • Node.js and npm installed (to run the agent-server MCP package via npx)
  • An API key for at least one cloud LLM provider (e.g., ANTHROPIC_API_KEY, OPENAI_API_KEY) if not using a local model
  • Xcode Command Line Tools installed if you plan to use Xcode build tools
  • Full Disk Access granted to Agent! in System Settings if you want iMessage monitoring
1

Download and install Agent!

Download the Agent! macOS app from the GitHub releases page and drag it to your Applications folder. Alternatively, clone the source and build with the provided script.

git clone https://github.com/macos26/agent.git
cd Agent
./build.sh Release
2

Launch Agent! and configure an LLM provider

Open Agent! from your Applications folder. Go to Settings, select your preferred AI provider (e.g., Claude, OpenAI, Ollama), and enter the corresponding API key. Approve the privileged daemon when prompted.

3

Add the MCP server to your client config

To use Agent!'s capabilities from an external MCP client (such as Claude Desktop), add the agent-server npm package to your MCP configuration.

{
  "mcpServers": {
    "agent": {
      "command": "npx",
      "args": ["-y", "agent-server"]
    }
  }
}
4

Grant required system permissions

For full functionality, grant Agent! Accessibility permissions (for UI automation), Full Disk Access (for iMessage via chat.db), and any other permissions macOS prompts for during first use.

5

Test the connection

In Agent! or your external MCP client, ask the AI to list available tools or perform a simple task such as reading the current directory. This confirms the agent daemon is running.

Agent Examples

Client configuration

Claude Desktop config block to connect to the Agent! MCP server via the agent-server npm package.

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

Prompts to try

Example tasks you can send directly in Agent! or via a connected MCP client.

- "Build the Xcode project in ~/Projects/MyApp and fix any compiler errors."
- "Commit all staged changes with a meaningful message and open a pull request."
- "Open Safari and search for the latest macOS release notes."
- "Send an iMessage to Mom saying I'll be home by 6pm."
- "Refactor the AuthManager class into smaller, single-responsibility files."
- "Run the test suite and show me any failures."

Troubleshooting Agent

The agent cannot send iMessages or read chat history

Grant Full Disk Access to Agent! in System Settings > Privacy & Security > Full Disk Access. Without this, the app cannot read ~/Library/Messages/chat.db.

UI automation tools fail with an accessibility error

Go to System Settings > Privacy & Security > Accessibility and ensure Agent! is listed and toggled on. You may need to remove and re-add it after a macOS update.

Local Ollama models are slow or fail to load

Local model support requires Apple Silicon with sufficient unified memory (64–128 GB for 30B+ parameter models). Confirm Ollama is installed and running ('ollama serve') and that the model is pulled ('ollama pull <model-name>').

Frequently Asked Questions about Agent

What is Agent?

Agent is a Model Context Protocol (MCP) server that agent! is a native macos app that works with any llm [local and cloud], [open source and paid] claude, openai, gemini, ollama, qwen, hugging face, and 12 more. writes code, builds xcode projects, bump versions, manages git, automates safari (applescr It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Agent?

Install via npm with the command: npx -y agent-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with Agent?

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

Is Agent free to use?

Yes, Agent is open source and available under the MIT 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": { "agent": { "command": "npx", "args": ["-y", "agent-server"] } } }

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

Read the full setup guide →

Ready to use Agent?

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