Skip to content

Changelog

New updates and improvements to Macuse.

v1.6.0

1.6.0 — Full UI Automation

AI can now drag, scroll, manage windows, and navigate file dialogs, with visual screenshots to see what's on screen.

New Features

  • New interaction tools — Drag & drop, scroll, click by position or fuzzy text match
  • Window management — Close, minimize, fullscreen, move, and resize windows
  • App automation — Navigate file dialogs and interact with Dock items
  • Visual snapshots — Annotated screenshots with labeled UI elements for better context

Improvements

  • Clearer element labels — Labels now reflect roles (B1 for buttons, T2 for text fields) for faster identification
  • More reliable automation — Element references stay consistent across multi-step workflows
  • Faster screenshots — Significantly faster snapshot rendering

Bug Fixes

  • Mail — Fixed reading certain emails in IMAP accounts with nested folders
  • Text input — Fixed append mode (clear_before: false) replacing text instead of appending to existing content
  • Frontmost app — Fixed crash when querying frontmost app with no active window (e.g., all windows minimized)
v1.5.0

1.5.0 — Mail Attachments & Smart Reconnect

Full attachment support for Mail and seamless CLI reconnection.

New Features

  • Mail attachments — Read and analyze email attachments
    • View images and extract text from PDFs directly in conversation
    • Search for emails with attachments using the new filter
    • Send emails with attachments
  • Interactive Tools toggle — Enable or disable interactive UI cards per connected client

Improvements

  • Auto-reconnect — CLI reconnects automatically when the app restarts
  • Smarter mail operations — Reply and forward work with any message format
  • Better reliability — Responses no longer get cut off for large results
  • Faster loading — Optimized MCP Apps bundle size
v1.4.0

1.4.0 — Rich MCP UI Cards

Richer tool responses with dedicated UI cards for mail, notes, reminders, and calendar.

New Features

  • MCP Apps support — Tools now return interactive UI cards instead of plain text, for a more visual and scannable experience
  • Native app integration — Open items directly in Mail, Calendar, Notes, or Reminders with one click

Improvements

  • Deep link reliability — More dependable app launching with proper URL handling
  • OAuth resilience — Better error handling and client registration
  • Performance — Faster UI rendering with improved caching

Learn More

v1.3.0

1.3.0 — Stickies & Stable UI Refs

New Stickies integration and more reliable UI automation.

New Features

  • Stickies integration — Read and create Apple Stickies notes, list all stickies with search, and create new ones with custom colors
  • RefID system — UI elements now get short refs (e1, e2, ...) instead of fragile XPaths, with flexible syntax (@e1, ref=e1, or just e1)
  • Usage indicator — Free users can now see daily tool call count in the footer with real-time updates

Improvements

  • License management — Activate and deactivate licenses through a cleaner modal interface with confirmation dialogs
v1.2.1

1.2.1 — License UX Improvements

Small improvements to the license activation experience.

Improvements

  • Clearer error messages — License errors are now more concise and actionable
  • Auto-dismiss errors — Error messages automatically disappear after 30 seconds
v1.2.0

1.2.0 — Low Context Mode

Better support for LLMs with limited context windows.

New Features

  • Low Context Mode — Optimized responses for low context LLMs.
    • Only exposes 2 meta-tools (get_tool_definitions and call_tool_by_name) to minimize context usage.
    • Enable in Server Settings → Default Low Context Mode, or toggle individually per client in Connections
  • Flexible input formats — Calendar events, reminders, notes, and apps can now be referenced using natural formats, not just structured objects

Improvements

  • Smarter tool discovery — New get_tool_definitions supports wildcard patterns (e.g., calendar_*) and returns usage hints to help LLMs use tools more effectively
  • Dynamic instructions — Server instructions automatically adapt based on which tools you have enabled

Bug Fixes

  • Session stability — Fixed token refresh issues that could cause disconnections
  • Local connections — Fixed OAuth validation for localhost aliases (127.0.0.1, localhost, 0.0.0.0)
v1.1.1

1.1.1 — Stability & Compatibility

Bug fixes and compatibility improvements.

Improvements

  • UI Viewer — New head/tail mode for extracting text from the beginning or end of UI elements
  • Client detection — Now recognizes LM Studio, Msty Studio, and Perplexity

Bug Fixes

  • Tool compatibility — Fixed issues where some MCP clients couldn't properly read tool parameters
  • Text handling — Fixed a crash when processing text with Chinese or other multi-byte characters
v1.1.0

1.1.0 — Flexible Authentication

New authentication options and improved compatibility for more MCP clients.

New Features

  • Bearer Token authentication — Generate long-lived bearer tokens to authenticate MCP clients without OAuth flows, perfect for headless environments and automation
  • Client detection — Automatically identify which application is connecting to the MCP server, with configuration snippets tailored to each client
  • Legacy SSE transport — Support for MCP clients that don't use Streamable HTTP (e.g., older Claude Desktop versions)

Improvements

  • CLI performance — Optimized CLI module with faster startup and reduced overhead
  • Client limit modal — Improved UI with clearer icons and better user experience

Bug Fixes

  • Mail tool compatibility — Fixed Mail tools not working with some MCP clients like Perplexity
v1.0.3

1.0.3 — Streamlined Experience

Improved onboarding guidance, enhanced AI tool interactions, and Mail reliability fixes.

Improvements

  • Onboarding guidance — The setup completion screen now shows where to find macuse in your menu bar, making it easier to access the app after onboarding
  • Optimized AI tool descriptions — Simplified tool schemas reduce token usage and provide cleaner information to AI clients
  • Keyboard shortcuts — Press ESC to close the panel, and use Enter/ESC to approve or deny OAuth authorization requests

Bug Fixes

  • Mail forward & reply — Fixed forwarding and replying to emails not working correctly
  • Mail message matching — Improved message identification with better sender matching and whitespace handling
  • Gmail folder support — Fixed finding hierarchical mailbox names like [Gmail]/All Mail
v1.0.2

1.0.2 — Simplified Setup

Easier Claude Desktop integration and improved reliability.

New Features

  • Claude Desktop setup — One-click configuration using the new .mcpb bundle format, replacing manual config file editing
  • Auto-launch control — New setting to control whether the desktop app launches automatically when using CLI mode

Bug Fixes

  • Purchase button — Fixed the "Purchase License" button not responding to clicks
  • Automation permissions — Fixed automation permission dialog not appearing on first use, which could prevent certain features from working