batiflow-mcp

MCP (Model Context Protocol) server for BatiFlow — macOS AI desktop automation.

Quick Start

npx batiflow-mcp

Or install globally:

npm install -g batiflow-mcp
batiflow-mcp

Claude Code Setup

Add to your Claude Code MCP config (~/.claude.json):

{
  "mcpServers": {
    "batiflow": {
      "type": "stdio",
      "command": "npx",
      "args": ["batiflow-mcp"]
    }
  }
}

Or use BatiFlow app: Settings > MCP > Select folder > Apply

Available Tools (21)

Messenger

| Tool | Description | |------|------------| | batiflow_send | Send message (KakaoTalk/Slack/iMessage) | | batiflow_read | Read chat messages | | batiflow_send_bulk | Bulk send to multiple recipients | | batiflow_chats | List chat rooms | | batiflow_friends | List KakaoTalk friends | | batiflow_contacts | List contacts |

Browser (Chrome CDP)

| Tool | Description | |------|------------| | batiflow_browser_navigate | Navigate to URL | | batiflow_browser_click | Click element | | batiflow_browser_get_text | Extract page text | | batiflow_browser_screenshot | Capture screenshot | | batiflow_browser_evaluate | Run JavaScript | | batiflow_browser_page_info | Get page URL/title |

Files

| Tool | Description | |------|------------| | batiflow_file_list | List directory contents | | batiflow_file_read | Read file content | | batiflow_file_write | Write file | | batiflow_file_search | Search files by name |

macOS Native

| Tool | Description | |------|------------| | batiflow_calendar_list | List upcoming events | | batiflow_notes_create | Create a note | | batiflow_reminders_create | Create a reminder | | batiflow_system_shell | Execute shell command | | batiflow_system_volume | Set system volume |

Requirements

• macOS 13+ (Ventura or later)
• Node.js 18+
• BatiFlow app installed for messenger/browser tools
• Accessibility permission granted for BatiFlow

Note

Messenger and browser tools require BatiFlow macOS app to be installed and running. File, calendar, notes, reminders, and system tools work independently via AppleScript/EventKit.

License

MIT — bati.ai