MCP Setup

Each AI tool has its own way of configuring MCP servers. Below are setup instructions for the most common tools.

Prerequisites

Before configuring any tool, make sure you have:

Node.js installed (v18 or later)
Authenticate — log in with the CLI before configuring any tool:

npx pushtodisplay auth login

The MCP server picks up your session automatically — no API keys or environment variables needed.

auth login supports a device code flow, so it works in headless environments too (remote servers, SSH sessions). See Authentication for all auth options.

Claude Code

Claude Code auto-discovers MCP servers. Add Push To Display with:

claude mcp add pushtodisplay -- npx pushtodisplay mcp

Claude Desktop

Edit your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "pushtodisplay": {
      "command": "npx",
      "args": ["pushtodisplay", "mcp"]
    }
  }
}

Restart Claude Desktop after saving.

Cursor

Open Cursor Settings → MCP Servers → Add Server, then enter:

Name: pushtodisplay
Command: npx pushtodisplay mcp

Or edit .cursor/mcp.json in your project:

{
  "mcpServers": {
    "pushtodisplay": {
      "command": "npx",
      "args": ["pushtodisplay", "mcp"]
    }
  }
}

VS Code (GitHub Copilot)

Add to your VS Code settings (.vscode/mcp.json):

{
  "servers": {
    "pushtodisplay": {
      "command": "npx",
      "args": ["pushtodisplay", "mcp"]
    }
  }
}

Other MCP clients

Any MCP client that supports stdio transport can use Push To Display. The server command is:

npx pushtodisplay mcp

Configure it as a stdio server with the command npx and arguments ["pushtodisplay", "mcp"].

For other authentication methods (API keys, access tokens), see Authentication.

Verify it's working

Once configured, ask your AI agent something like:

"List my Push To Display boards"

If the server is running and authenticated, it should call pushtodisplay_list_boards and show you your boards.