The Leedz logo accent

Install Guide



Sections:

•    Chrome Extension •    Windows Server •    MCP Plugin (AI Chat)

The app is currently in beta.
These instructions are for sideloading until the Leedz is published on the Chrome Web Store.

Chrome Extension

Download & Extract

  • Download leedz_browser_extension.zip
  • Right-click the ZIP → Extract All... to a permanent folder
  • Do not delete this folder after install — the extension needs it

Load into Chrome

  • Open Chrome and go to chrome://extensions
  • Turn on Developer mode (toggle in top-right corner)
  • Click Load unpacked and select the extracted folder
  • The Leedz icon appears in your Chrome toolbar — click it to start

Troubleshooting

  • Security warning: Chrome warns about extensions not from the Web Store. This is normal — the extension is safe.
  • Extension disabled after Chrome update: Go to chrome://extensions and re-enable it.

Windows Server

Requirements: Windows 10+ (64-bit), 50 MB disk space, port 3000 available

Download & Extract

  • Download leedz-server-win-x64.zip from theleedz.com
  • Right-click the ZIP → Extract All... to a permanent folder
  • Do not delete this folder — it contains your database and settings

Start the Server

  • Double-click launch_leedz.bat
  • A tray icon appears (bottom-right) and a command window opens
  • When you see "Server listening on port 3000", it's ready
  • Leave the command window open while using Leedz

Connect Your Chrome Extension

  • On the Chrome extension's Startup page, enter: localhost / port 3000
  • The database name will appear when connected

Auto-Start on Boot (recommended)

  • Right-click the Leedz tray icon → Settings
  • Check "Start TheLeedz automatically when Windows starts" → Save

Stop / Restart: Close the command window (or right-click tray → Exit). To restart, double-click launch_leedz.bat again.

Configuration

  • Change port: Edit server_config.json, change the port number, restart, and update the Chrome extension Startup page.
  • Backup data: Copy data\leedz.sqlite to a safe location.
  • Server log: Check server.log in the install folder for errors.

Troubleshooting

  • Port in use: Another program is on port 3000. Stop it or change the port in server_config.json.
  • Firewall warning: Click "Allow access" — the server runs locally only.
  • Won't start: Make sure all files were extracted. Try right-click → Run as administrator.
  • Extension can't connect: Verify the server is running (tray icon + command window). Check that the port matches.

MCP Plugin (AI Chat)

The MCP plugin connects AI chat clients like Claude Desktop and LM Studio to your local Leedz database. Manage clients and bookings using natural language — e.g., "show all the April birthday parties I've ever booked"

Your data never leaves your machine. No cloud, no hosting fees.

Prerequisites

  • Node.js installed (nodejs.org) — check with node --version in a command prompt
  • Leedz Server installed and running on localhost:3000 (see above)
  • An AI chat client that supports MCP

Claude Desktop (Windows)

1. Open your config file:

C:\Users\<YourUsername>\AppData\Roaming\Claude\claude_desktop_config.json

If it doesn't exist, create it.

2. Add the leedz-mcp server (update the paths for your system):

{ "mcpServers": { "leedz-mcp": { "command": "C:\\Program Files\\nodejs\\node.exe", "args": ["C:\\PATH_TO_LEEDZ\\server\\mcp\\mcp_server.js"] } }, "globalShortcut": "" }

If you already have other MCP servers, add leedz-mcp inside the existing mcpServers object.

3. Save and restart Claude Desktop.

4. Verify: type "list all clients from the Leedz" — you should see your client list.

LM Studio

1. Open LM Studio → find the Integrations panel on the right side.

2. Click Install dropdown → MCP → Edit mcp.json

3. Add the leedz-mcp server (update the path):

{ "mcpServers": { "leedz-mcp": { "command": "C:\\Program Files\\nodejs\\node.exe", "args": ["C:\\PATH_TO_LEEDZ\\server\\mcp\\mcp_server.js"] } } }

If you already have other MCP servers, add leedz-mcp inside the existing mcpServers object.

4. Save and restart LM Studio.

5. Verify: type "show me all bookings from the Leedz" — you should see your booking list.

Path Notes

  • Replace <YourUsername> and PATH_TO_LEEDZ with your actual paths
  • Use double backslashes (\\) in all Windows paths in JSON
  • If your server runs on a different port, edit server/mcp/mcp_server_config.json and change the apiUrl

Support: theleedz.com@gmail.com