Install Chrome Browser Extension

12/2025: These instructions are temporary, until the Leedz is registered with Google and available on the App Store. Then the install will be easier, but the program will be harder to update. While the app is in beta, and we are taking your feature requests and bug reports please endure this more cumbersome process.

STEP 1: DOWNLOAD AND EXTRACT

  • Download leedz_browser_extension.zip
  • Right-click the ZIP file and select Extract All...
  • Choose a permanent location (C:/Program Files/TheLeedz ?)
    IMPORTANT: Do not delete this folder after install, the extension needs it
  • Click Extract


STEP 2: OPEN CHROME EXTENSIONS PAGE

  • Open Google Chrome browser
  • In the address bar, type: chrome://extensions
  • Press Enter


STEP 3: ENABLE DEVELOPER MODE

Look for a toggle switch labeled Developer mode in the top-right corner. Click it to turn it ON (it should turn blue).


STEP 4: LOAD THE EXTENSION

  • Click the Load unpacked button (appears after Developer mode)
  • Browse to the folder you extracted in Step 1
  • Select the folder and click Select Folder
  • The Leedz extension will appear in your extension list


STEP 5: START USING LEEDZ

Look for the Leedz icon in your Chrome toolbar (top-right). Click it to start creating invoices!


TROUBLESHOOTING

SECURITY WARNING: Chrome will show a warning that this extension is not from the Chrome Web Store. This is normal for business software that hasn't been published publicly. The extension is safe to use.

EXTENSION DISABLED: If Chrome disables the extension after an update, simply return to chrome://extensions and re-enable it.

SUPPORT: theleedz.com@gmail.com




Install Leedz Windows Server

SYSTEM REQUIREMENTS

  • Windows 10 or later (64-bit)
  • .NET 8 Runtime (usually pre-installed on modern Windows)
  • Port 3000 available (or configure a different port)
  • 50 MB disk space


STEP 1: DOWNLOAD AND EXTRACT

  • Download "leedz-server-win-x64.zip" from theleedz.com
  • Right-click the ZIP file and select Extract All...
  • Choose a permanent location (like C:\Program Files\TheLeedz ?)
    IMPORTANT: Don't delete this folder after installation. This is where your database and settings are stored
  • Click Extract


You should see a folder containing:

  • TheLeedz.exe (System tray application)
  • leedz-server.exe (Backend server)
  • launch_leedz.bat (Startup script)
  • prisma/ folder (Database and schema)
  • server_config.json (Server settings)
  • img/ folder (Icons)


STEP 2: START THE SERVER

  • Double-click "launch_leedz.bat" in the extracted folder
  • A small icon will appear in your Windows system tray (bottom-right)
  • A command window will open showing "Server starting on port 3000..."
  • When you see "Server listening on port 3000", it's ready!

The system tray icon lets you quickly access server controls and settings. Right-click the icon to see available options.


STEP 3: VERIFY IT'S WORKING

The server is now running and ready to connect with your Chrome extension. You can verify by:

  • Checking the system tray for the Leedz icon
  • The command window shows "Server listening on port 3000"


Leave the command window open while using Leedz. Closing it will stop the server.


STEP 4: CONNECT YOUR CHROME EXTENSION

Now install the Leedz Chrome extension (see separate instructions). The extension will automatically connect to your local server at http://localhost:3000


STOPPING AND RESTARTING

  • TO STOP: Close the command window or right-click the tray icon and select Exit
  • TO RESTART: Double-click launch_leedz.bat again


TO AUTO-START ON WINDOWS BOOT (Recommended):
  • Right-click the Leedz tray icon
  • Select Settings
  • Check the box: "Start TheLeedz automatically when Windows starts"
  • Click Save

Now Leedz will automatically start every time Windows boots!


TROUBLESHOOTING

PORT ALREADY IN USE: If you see "Port 3000 is already in use", another program is using that port. Either stop that program or edit server_config.jsonto change the port number.

FIREWALL WARNING: Windows may ask to allow network access. Click "Allow access" - the server only runs locally on your computer.

SERVER WON'T START: Make sure you extracted ALL files from the ZIP. Try running as Administrator (right-click launch_leedz.bat, select "Run as administrator").

EXTENSION CAN'T CONNECT: Verify the server is running (check for the tray icon and command window). Make sure no firewall is blocking localhost connections.

DATABASE ISSUES: Your database is stored in prisma/leedz.sqlite. To backup your data, copy this file to a safe location.

SUPPORT: theleedz.com@gmail.com


Install LLM-MCP STDIO Integration

The Leedz MCP (Model Context Protocol) plugin connects AI chat clients like Claude Desktop and LM Studio directly to your local Leedz database. This lets you manage clients and bookings using natural language in your favorite AI chat interface.

Example: "show all the April birthday parties I've ever booked"

THIS IS A STDIO PLUGIN

  • Runs locally on your computer as a background process
  • Communicates via stdin/stdout (text streams)
  • Your data NEVER leaves your machine
  • Near-instant response times (no network latency)
  • No monthly hosting fees or cloud infrastructure

LIMITATION:

Not all AI LLM clients support STDIO plugins. Currently tested on:
  • Anthropic Claude Desktop
  • LM Studio


BEFORE INSTALLING:

1. Node.js must be installed on your system
  • Required ONLY for the MCP plugin (runs as .js script)
  • The Leedz server.exe INCLUDES Node runtime (no separate install needed)
  • Check if Node is installed: Open command prompt, type "node --version"
  • If not installed: Download from https://nodejs.org

2. The Leedz Server must be installed and running
  • See server/INSTALL_INSTRUCTIONS.txt
  • Verify server is running on http://localhost:3000


3. An AI chat client that supports MCP (Claude Desktop or LM Studio)



INSTALL IN CLAUDE DESKTOP (Windows)

STEP 1: Locate your Claude Desktop config file

The config file is at: C:\Users\\AppData\Roaming\Claude\claude_desktop_config.json

Replace with your Windows username.

STEP 2: Open the config file in a text editor
  • Right-click the file, select "Open with > Notepad"
  • If the file doesn't exist, create it


STEP 3: Add the Leedz MCP server definition

If your config file is empty, paste this (UPDATE THE PATHS):

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


If your config file already has content, add the "leedz-mcp" section inside the existing "mcpServers" object:

{
"mcpServers": {
"leedz-mcp": {
"command": "C:\\Program Files\\nodejs\\node.exe",
"args": ["C:\\Users\\*YourUsername*\\Desktop\\WKG\\INVOICER\\server\\mcp\\mcp_server.js"]
},
"other-mcp-server": {
...existing servers...
}
},
"globalShortcut": ""
}


PATH NOTES:

  • Replace with your actual Windows username
  • Use DOUBLE BACKSLASHES (\\) in Windows paths
  • Update the path to match where you installed the Leedz server
  • Common install locations:
    C:\\Program Files\\Leedz\\mcp\\mcp_server.js
    C:\\Users\*YourUsername*\Desktop\\Leedz\\server\\mcp\\mcp_server.js


STEP 4: Save the file and restart Claude Desktop

STEP 5: Verify installation

Open Claude Desktop and type: "list all clients from the Leedz"

If configured correctly, you'll see your client list.



INSTALL IN LM STUDIO:

STEP 1: Open LM Studio

STEP 2: Navigate to the Integrations panel
  • Look for the right-side panel labeled "Integrations" or "Program"
  • If not visible, check the View menu or toolbar


STEP 3: Add MCP Server

  • Click the dropdown menu: "Install"
  • Select "MCP"
  • Click "Edit mcp.json"


STEP 4: Add the Leedz MCP server definition

Paste this into the editor (UPDATE THE PATH):

{
"mcpServers": {
"leedz-mcp": {
"command": "C:\\Program Files\\nodejs\\node.exe",
"args": [
"C:\\Users\\*YourUsername*\\Desktop\\WKG\\INVOICER\\server\\mcp\\mcp_server.js"
] } } }


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


PATH NOTES:

  • Replace with your actual Windows username
  • Use DOUBLE BACKSLASHES (\\) in Windows paths
  • Update the path to match your Leedz server installation


STEP 5: Save the file

STEP 6: Restart LM Studio

STEP 7: Verify installation

Open a chat and type: "show me all bookings from the Leedz"

If configured correctly, you'll see your booking list.



SETTINGS:

For detailed API endpoint documentation see: server/README.md

For MCP server configuration: server/mcp/mcp_server_config.json

For logs and debugging: server/mcp/mcp_server.log

CONFIG file location: server/mcp/mcp_server_config.json
  • database.apiUrl: URL of Leedz server (default: http://localhost:3000)
  • llm.api-key: Anthropic API key for natural language translation
  • llm.provider: Claude model used for translation (default: claude-opus-4-1)
  • logging.file: Path to log file (default: ./mcp_server.log)


If your Leedz server runs on a different port:

  • Edit server/mcp/mcp_server_config.json
  • Change "apiUrl": "http://localhost:3000" to your port
  • Restart the AI client


LOG FILE:

All plugin activity is logged to server/mcp/mcp_server.log

Check this file for debugging and troubleshooting.