Using WindowPin from an AI tool

With the MCP server connected, an AI tool can see which windows are open and attach a note or a label to one of them.

Before you start

This connection stays inside your PC. Note content never reaches our servers. The channel is open only to the account you are signed in as, and turning it off in settings means it is never opened at all.

1. Turn the connection on

Settings → Automation → “Allow tool access (MCP)” must be on. It is on by default.

2. Add it to Claude Code

One line in a terminal. Node 18 or newer is required.

claude mcp add windowpin -- npx -y windowpin-mcp

3. Cursor, Windsurf and others

Put this in the tool's mcp.json.

{
  "mcpServers": {
    "windowpin": {
      "command": "npx",
      "args": [
        "-y",
        "windowpin-mcp"
      ]
    }
  }
}

What the tools do

Tool	What it does
`windowpin_list_windows`	Open windows and how many notes each one carries
`windowpin_list_notes`	List notes, optionally just those on one window
`windowpin_search`	Search note text
`windowpin_pin_note`	Attach a multi-line note to a window
`windowpin_pin_label`	Attach a one-line label to a window's title bar
`windowpin_update_note`	Change a note's text, colour or mode
`windowpin_remove_note`	Move a note to the trash
`windowpin_add_rule`	Create a rule that attaches something whenever a matching window appears

If WindowPin is not running

Nothing throws. The tool answers “WindowPin is not running, or the connection is turned off” and the AI tool passes that straight back to you.

Back to WindowPin →