# Macuse MCP

MCPB Bundle for connecting Claude Desktop to [Macuse](https://macuse.app).

## What is Macuse?

Macuse is an MCP server for macOS that connects AI assistants to native apps and system automation.

| Toolbox             | Capabilities                                                                       |
| ------------------- | ---------------------------------------------------------------------------------- |
| **Calendar**        | View calendars, search events, create/reschedule meetings, find free time slots   |
| **Reminders**       | Create reminders with due dates and priorities, mark complete, search across lists |
| **Mail**            | Search emails, read content, compose/send/reply, move between mailboxes           |
| **Messages**        | Search iMessage conversations, send messages, retrieve chat history               |
| **Notes**           | Browse folders, full-text search, create and edit notes                           |
| **Contacts**        | Look up contacts by name/email/phone/company                                      |
| **Maps & Location** | Place search, directions, travel time, current location                           |
| **UI Viewer**       | Inspect any app's UI hierarchy, read visible text, find elements                  |
| **UI Controller**   | Click buttons, type text, press shortcuts, control any application                |

All processing runs locally on your Mac.

## Why This MCP Bundle?

Claude Desktop doesn't support `http://` remote connectors directly. This `.mcpb` provides a way to connect without manually editing configuration files.

## Installation

### Prerequisites

1. Download Macuse from https://macuse.app/download/
2. Drag `Macuse.app` into `/Applications`
3. Launch and grant the necessary permissions

### Install MCP Bundle

Download `macuse.mcpb` from [Releases](https://github.com/macuse-app/macuse-mcp/releases) and double-click to install in Claude Desktop.

To uninstall, remove it from Claude Desktop settings.

## Alternative: Direct CLI

For MCP clients that support custom commands, you can skip this MCP bundle and configure directly:

```json
{
  "mcpServers": {
    "macuse": {
      "command": "/Applications/Macuse.app/Contents/MacOS/macuse",
      "args": ["mcp"]
    }
  }
}
```

## First Connection

1. Macuse launches automatically if not running
2. Approve the OAuth authorization prompt
3. Connection established

Each client gets separate authorization, manageable in Macuse settings.

## Links

- Macuse Website: https://macuse.app/
- Macuse Download: https://macuse.app/download/
- MCP: https://modelcontextprotocol.io/
README

Installation
