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
Two lines in a terminal. Node 18 or newer is required.
curl.exe -L -o "$env:USERPROFILE\windowpin-mcp.cjs" https://windowpin.com/windowpin-mcp.cjs
claude mcp add windowpin -- node "$env:USERPROFILE\windowpin-mcp.cjs"The npm package is not out yet. Until it is, the single file above is all you need.
3. Cursor, Windsurf and others
Put this in the tool's mcp.json.
{
"mcpServers": {
"windowpin": {
"command": "node",
"args": [
"C:\\Users\\<name>\\windowpin-mcp.cjs"
]
}
}
}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 notes and labels by text and checklist items |
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 |
windowpin_list_rules | List the auto-attach rules: which windows they match and what they attach |
windowpin_remove_rule | Delete an auto-attach rule (labels it already attached stay) |
windowpin_app_info | Check that WindowPin is reachable and show its version |
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.