Your Mac agent should be inspectable.

Hunch’s automation engine, Python SDK, MCP server, permission gates, and credential-handling paths are open source.

View the repository Apache 2.0 license ↗

PrithviSeran / hunch-mcppublic

sdk.pyDeveloper-facing Python API

server.pyMCP tools for connected agents

agent.pyClaude and Codex agent loop

local_mac.pymacOS accessibility engine

cdp.pyBackground web and Electron control

creds.pyLocal Keychain access

policy.pyPermission and approval rules

One package, three ways to use it.

The hunch-sdk package includes the Python SDK and the local MCP server. Optional agent extras add a Claude or Codex-powered loop.

SDKAutomate deterministic Mac workflows from Python.

MCPGive any compatible agent focus-free Mac tools.

AgentRun a complete task with Claude or Codex.

Terminal

$ pipx install hunch-sdk

$ hunch setup
$ hunch doctor

# connect to an MCP host
$ hunch connect cursor

Found a bug or have an idea?

Open an issue, inspect the implementation, or send a pull request. Security-sensitive reports should avoid posting secrets or exploit details in a public issue.

Open an issue Read the security model

Hunch is an independently maintained open-source project provided under the Apache License 2.0 and on an “AS IS” basis.