Affinity MCP Server

Affinity MCP Server

Let AI control Affinity creative suite on macOS

The poster above was designed in Affinity and exported by Claude — through this very MCP server.

What is this?

An MCP (Model Context Protocol) server that gives AI assistants like Claude full control over the Affinity creative suite on macOS. It bridges the gap between AI and professional design software — launch apps, navigate menus, draw shapes, apply filters, export files, and more — all through natural language.

Features

• 23 tools covering the complete Affinity workflow
• Unified Affinity app support (Affinity by Canva)
• Menu navigation — browse and click any menu item up to 4 levels deep
• UI inspection — read buttons, dialogs, text fields, and interact with them
• Mouse & keyboard — click, drag, type text, send shortcuts and key codes
• Screenshots — capture the Affinity window for visual feedback
• Document ops — create, open, save, export, flatten, rotate, flip
• Layers & filters — add layers, list filters, import macros

Prerequisites

• macOS (uses AppleScript and System Events)
• Affinity by Canva (v2 — the unified app)
• Bun runtime (v1.0.0+)
• Accessibility permissions — System Settings > Privacy & Security > Accessibility — grant access to your terminal app and/or Claude Desktop

Quick Start

# Clone the repo
git clone https://github.com/sekharmalla/affinity-mcp-server.git
cd affinity-mcp-server

# Install dependencies
bun install

# Run the server
bun run start

Install as Claude Code Plugin

The easiest way to get started with Claude Code — one command, no manual config:

claude plugin add /path/to/affinity-mcp-server

This automatically:

• Registers the MCP server (all 23 tools available immediately)
• Installs the affinity-design skill — workflow guidance that teaches Claude how to orchestrate the tools for real design tasks (create posters, export files, navigate menus, etc.)

The skill is the key value-add: the MCP tools are low-level primitives (click here, type this), but the skill provides high-level workflow knowledge (how to create a poster, how to export for web, how to navigate Affinity's UI patterns).

Configuration

Add the server to your AI client's MCP configuration:

Claude Code

claude mcp add affinity-mcp-server bun run /path/to/affinity-mcp-server/index.ts

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "affinity-mcp-server": {
      "command": "bun",
      "args": ["run", "/path/to/affinity-mcp-server/index.ts"]
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "affinity-mcp-server": {
      "command": "bun",
      "args": ["run", "/path/to/affinity-mcp-server/index.ts"]
    }
  }
}

VS Code

Add to .vscode/mcp.json in your workspace:

{
  "servers": {
    "affinity-mcp-server": {
      "command": "bun",
      "args": ["run", "/path/to/affinity-mcp-server/index.ts"]
    }
  }
}

Tool Reference

App Lifecycle

File Operations

Menu System

UI Inspection & Interaction

Input