Osaurus
Own your AI. The native macOS harness for AI agents -- any model, persistent memory, autonomous execution, cryptographic identity. Built in Swift. Fully offline. Open source.
What is Osaurus?
Osaurus is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to own your ai. the native macos harness for ai agents -- any model, persistent memory, autonomous execution, cryptographic identity. built in swift. fully offline. open source.
Own your AI. The native macOS harness for AI agents -- any model, persistent memory, autonomous execution, cryptographic identity. Built in Swift. Fully offline. Open source.
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Own your AI. The native macOS harness for AI agents -- any m
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx osaurusConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Osaurus
Osaurus is a native macOS AI agent harness built in Swift that runs AI models fully offline on Apple Silicon hardware, providing persistent memory, autonomous execution, cryptographic identity, and 20+ native macOS plugins including Mail, Calendar, Browser, Git, Filesystem, and Vision. It exposes a stdio MCP server via 'osaurus mcp' that bridges connected MCP clients to its local plugin ecosystem, supporting any model through OpenAI, Anthropic, and Ollama-compatible endpoints. Privacy-conscious developers and power users use it to run capable AI agents entirely on-device without sending data to the cloud.
Prerequisites
- macOS 15.5 or later
- Apple Silicon Mac (M1/M2/M3/M4 series) — required for MLX model inference
- Osaurus installed via Homebrew or the official .dmg from GitHub Releases
- An MCP-compatible client such as Claude Desktop (optional — Osaurus has its own chat UI)
Install Osaurus via Homebrew
Install Osaurus using Homebrew Cask for the easiest setup. Alternatively, download the .dmg from the GitHub Releases page.
brew install --cask osaurusStart the Osaurus server
Launch the background server that handles model inference and plugin execution. Specify a port and optionally expose it on your local network.
osaurus serve --port 1337Verify the server is running
Check the server status to confirm it is active and accepting connections.
osaurus statusInstall desired native plugins
Add the plugins you want available to AI agents. The browser plugin enables web automation; other plugins add Mail, Calendar, Git, and filesystem access.
osaurus tools install osaurus.browser
osaurus tools listConnect an MCP client to Osaurus
Add Osaurus to your MCP client configuration using the 'osaurus mcp' command, which starts a stdio MCP server that proxies tool calls to your local Osaurus HTTP server.
{
"mcpServers": {
"osaurus": {
"command": "osaurus",
"args": ["mcp"]
}
}
}Open the built-in chat UI
Alternatively, use Osaurus's own chat interface to interact with agents directly without a separate MCP client.
osaurus uiOsaurus Examples
Client configuration
MCP client configuration to connect Claude Desktop or another client to Osaurus's local plugin ecosystem.
{
"mcpServers": {
"osaurus": {
"command": "osaurus",
"args": ["mcp"]
}
}
}Prompts to try
Interact with macOS natively through Osaurus plugins — all processing stays on your device.
- "Check my Calendar for meetings tomorrow and draft a prep email to the first attendee"
- "Search my filesystem for any PDF files modified in the last 7 days"
- "Use the Browser plugin to open GitHub and list my open pull requests"
- "Read my last 5 emails and summarize the action items"
- "Clone the repository at github.com/example/repo and show me the recent commit history"Troubleshooting Osaurus
Osaurus fails to install with 'macOS 15.5 required' error
Osaurus requires macOS 15.5 or later and Apple Silicon. Check your macOS version with 'sw_vers -productVersion' and update if needed through System Settings > General > Software Update.
Model inference is slow or fails to load
Set the OSU_MODELS_DIR environment variable to a fast SSD path if your default home directory is on a slow volume. Ensure you have at least 8GB of unified memory; smaller models work better on 8GB configurations.
MCP client cannot connect to 'osaurus mcp'
Ensure the Osaurus server is running first with 'osaurus serve --port 1337', then check 'osaurus status'. The MCP bridge requires the server to be active. If the osaurus binary is not in PATH for your MCP client's shell, specify the full path in the config: '/opt/homebrew/bin/osaurus'.
Frequently Asked Questions about Osaurus
What is Osaurus?
Osaurus is a Model Context Protocol (MCP) server that own your ai. the native macos harness for ai agents -- any model, persistent memory, autonomous execution, cryptographic identity. built in swift. fully offline. open source. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Osaurus?
Follow the installation instructions on the Osaurus GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Osaurus?
Osaurus works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Osaurus free to use?
Yes, Osaurus is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Osaurus Alternatives — Similar Coding Agents Servers
Looking for alternatives to Osaurus? 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 Osaurus 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 Osaurus?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.