# toolpiper [Health: Active]

**Category:** 🖥️ OS Automation  
**Repository:** https://github.com/ModelPiper/toolpiper.git  
**GitHub Stars:** 3  
**Views:** 6  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/toolpiper

## Description
300+ on-device MCP tools for macOS — local AI, voice, vision, browser automation, system control.

## Claude Desktop Quick Installation
No generated config for this server: it installs through its own setup steps.

The project's own setup steps (from https://github.com/ModelPiper/toolpiper.git), copied verbatim. Run them in order; they are not an mcpServers config.

1. Configure:

```sh
brew tap modelpiper/tap
```

2. Configure:

```sh
brew trust modelpiper/tap
```

3. Install:

```sh
brew install --cask toolpiper
```

4. Add to Claude Code:

```sh
claude plugin marketplace add ModelPiper/toolpiper
```

5. Install:

```sh
claude plugin install toolpiper@modelpiper
```

6. Add to Claude Code:

```sh
claude mcp add -s user --transport http toolpiper http://127.0.0.1:9998/mcp
```

## Documentation

## What toolpiper MCP server does

The toolpiper MCP server turns a Mac into an MCP-accessible tool host. Its catalog contains more than 400 tools, along with five resources and five workflow prompts. The available functions span local language-model inference, speech recognition and synthesis, Apple framework-based vision and text analysis, document retrieval, browser control, browser testing, video workflows, system automation, model management, and selected research or outreach services.

The server is bundled with ToolPiper, a native macOS application. The application also provides a local OpenAI-compatible API on port 9998 and can run local models using llama.cpp on Metal, Apple Intelligence, and Neural Engine speech features. The repository contains the server manifest, setup material, and client plugins; the application itself is proprietary.

## How it works

ToolPiper exposes MCP through Streamable HTTP at `http://127.0.0.1:9998/mcp`. It does not provide a stdio server. Loopback clients connect without a token or OAuth flow, while LAN and remote connections use bearer-token authentication. The endpoint also supports the MCP `GET /mcp` channel used for tool-list change notifications.

The catalog can be narrowed at connection time. Add `category` to request a single area, such as core inference, or use a `profile` such as `automation` to select a predefined group. Filtering changes both the advertised tools and the server instructions. Resources include status, model, backend, test, and category information; supplied prompts cover tasks such as model setup, page auditing, test creation, voice-over work, and topic research.

## Setup and configuration

Install ToolPiper from the project download page or through the ModelPiper Homebrew tap, then launch the app once. Configure an MCP client with the loopback URL. Claude Code and Codex also have repository plugins, while Claude Desktop uses a downloadable `.mcpb` extension that forwards stdio requests to the HTTP endpoint. The Claude Desktop extension exposes a reduced directory profile that excludes tools using AI models to generate images, video, or audio.

No environment variables are required by the documented setup. Local use does not require an account or API key. Model downloads require network access, and cloud providers or web-targeting tools may make additional connections.

## Tools and capabilities

The catalog includes tools for:

- Local chat, transcription, speech synthesis, embeddings, model search, download, and loading.
- OCR, image analysis, text analysis, and hybrid HNSW/BM25 retrieval.
- Chrome automation through CDP, including accessibility snapshots, actions, assertions, interception, Web Vitals, and coverage.
- Saved browser test sessions with replay and Playwright or Cypress export.
- Windows, Spaces, clipboard, displays, Finder, Calendar, Reminders, Contacts, notifications, processes, network, Bluetooth, and Shortcuts.
- Screen-recorded video workflows with timeline editing and OTIO, FCP XML, or EDL export.

## Limitations and notes

The toolpiper MCP server is macOS-only and requires macOS 26 or newer on Apple Silicon. The free offering includes the local model runner and speech features; access to more catalog areas depends on the current paid plan. Local inference, speech, vision, retrieval, and system actions can run on-device, but ToolPiper still contacts its servers for updates, licensing when signed in, and activity reporting, with optional usage counts configurable in Settings. The repository license applies to its manifest, plugin, and guides, not to the proprietary app.

_Full upstream README: https://allmcps.com/mcp/toolpiper/readme_