Noticky WallDocs

Search features, workflows, shortcuts, sync and troubleshooting.

Search features, workflows, shortcuts, sync and troubleshooting.

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.

MacUpdated 2026-10-09

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.

screenshotSettings → AI Access and client connection assistant
Visual placeholder — replace with a production asset later.