AI-integration

AI Integration

Hamaki can connect to AI assistants like Claude Desktop and OpenCode via MCP (Model Context Protocol). Once connected, you can ask questions about your schedule in plain language. With a Pro subscription, you can make changes to it too.

Everything stays on your Mac. No data is sent to Hamaki's servers or anywhere else.

What you can ask

Available on all plans:

  • "Who do I have tomorrow?"
  • "When is my next free slot?"
  • "What calendars do I have?"

Pro only:

  • "When did I last see Jan de Vries?"
  • "How many appointments have I had this month?"
  • "What's my busiest day of the week?"
  • "Cancel my 3pm on Friday"
  • "Move my Wednesday 2pm to Thursday 3pm"
  • "Delete the empty spots on Tuesday afternoon"

For write actions, the AI will confirm what it's about to do before making any changes.

Supported AI assistants

Assistant Status
Claude Desktop Supported
OpenCode Supported
ChatGPT Not supported (requires a public server)

Setting it up

  1. Open Hamaki Settings → AI Integration
  2. Toggle Enable AI Integration on
  3. Select your AI assistant (Claude Desktop or OpenCode)
  4. Click Apply automatically (Hamaki writes the config entry directly into the right file)
  5. Restart your AI assistant

Hamaki's tools will appear automatically once the assistant restarts.

If you prefer to configure manually, use the Copy snippet button and paste the config into your AI client's config file yourself. The Open file button takes you directly to the right location.

Privacy

The MCP server only listens on 127.0.0.1, your own machine. It is not reachable from your local network or the internet. The AI reads your schedule data locally and processes it through its own API; nothing passes through Hamaki's backend.

You can disable the integration at any time from Settings → AI Integration.

Troubleshooting

Tools don't appear in my AI assistant
Make sure you restarted the AI assistant after applying the config. If it still doesn't work, try the Open file button to verify the config was written correctly, then restart again.

Hamaki is not running when I ask a question
Start Hamaki first, then try again. The AI will return a friendly error if Hamaki is not running when a tool is called.

I'm on the free plan and write tools don't work
Write tools (cancel, move, delete) and visitor history require a Pro subscription. Upgrade from the Account screen in the app.