AI Access and MCP
Connect MCP-compatible tools such as Claude or Codex to local Wall data with explicit Off, Read only and Read & edit permissions.
Wall for Mac can expose a localhost-only MCP service so compatible AI/automation clients can read, and when explicitly allowed, edit local Wall data.
Enable AI Access
Open Settings → AI Access and choose:
- Off — listener stopped; default
- Read only — tools can inspect workspace data but write calls fail closed
- Read & edit — approved clients can call supported mutation tools
Changing Read only ↔ Read & edit updates access policy without requiring a listener restart. Turning Off synchronously stops active access.
Available tools
The MCP catalog exposes:
- wall_list_spaces
- wall_list_views
- wall_search_objects
- wall_get_object
- wall_get_canvas
- wall_plan_canvas_changes
- wall_apply_canvas_plan
- wall_create_object
- wall_update_object
- wall_create_relation
- wall_delete_object
The catalog stays stable; permissions are enforced when a tool is called.
Building Canvas diagrams with an agent
An MCP client can inspect the real objects and placements on a Canvas using wall_get_canvas, then prepare a validated plan through wall_plan_canvas_changes. A plan may create Notes, Tasks, Frames, Shapes, Text, Code cards and bound Connectors, move existing placements, edit text, and apply the same Grid, Smart Arrange, Flowchart and Mind Map layouts available in Wall's Canvas editor.
Planning does not modify the workspace. The result includes a temporary plan ID and a structured geometry preview. After reviewing the intended changes, a client with Read & edit permission can call wall_apply_canvas_plan. Wall refuses the plan if the Space changed since it was prepared, if it expired, or if another MCP session tries to apply it.
Applied changes are recorded as one attributed Workspace batch in Agent Activity and support guarded Safe Revert. The planning result describes proposed objects and positions; review-required plans also show a placement outline preview in Wall for Mac. There is no screenshot API.
Review changes before applying
Ask your AI client to prepare Canvas changes for review. Wall for Mac highlights additions, moved objects (before/after), and updates. Use Show diff to toggle the preview or Fit changes to frame the affected areas. Choose Approve plan or Reject; nothing is applied before approval. Plans expire after five minutes, and plans must be regenerated if your Canvas changes.
Connect a client
Settings provides Connect an AI App… guidance for supported clients such as Claude Desktop, Claude Code, Codex and other MCP-compatible tools.
Normal setup exposes the signed helper path/configuration — never the bearer token or localhost bootstrap secret.
Security boundary
The server is loopback-only, bearer-authenticated and validates Host/origin/protocol/body limits. The bearer credential is managed by the native host and protected in the Mac app's private storage/App Group flow.
Writes use normal Wall operations
MCP does not write a second database. Mutations flow through the frontend Workspace store using external operation batches, so normal persistence, sync attribution and Agent Activity remain in force.