Overview
The Assignar MCP (Model Context Protocol) server allows your AI tool of choice (Claude, ChatGPT...) to your own Assignar data. This allows you to ask questions about your data, create dashboards and PDF prints, all using natural language prompts in your AI tool of choice.
Simply ask Claude/ChatGPT how to connect with https://mcp.assignar.com/ or follow the instructions below.
You need to have API access enabled in your account to setup the connection (Settings - API Access from the left hand nav). If you don't see API access, reach out to your customer success manager and they can assist with this add-on feature.
Available Tools / Data
The MCP allows you to fetch data, but not to write back to the Assignar database. You can ask questions like, how many hours did John Doe work last week? Or ask it to create a PDF print of all the site diaries for a particular client last week.
Over 90 data fields are available via the MCP connector - everything we expose via the Public API.
Claude Desktop Connection Instructions
Prerequisites
✓ Claude Desktop installed on your Mac
✓ Node.js v18 or higher
✓ Assignar API credentials — Client ID and Client Secret from your Assignar dashboard
Step 1 Get your credentials and add them to the config file
- Press Cmd + Shift + G in Finder (Go to Folder) and paste this path:
- ~/Library/Application Support/Claude/
- Open claude_desktop_config.json in any text editor (TextEdit, VS Code, etc.). If the file does not exist yet, create it.
- Paste the config below into the file, replacing the placeholder values with your Client ID and Client Secret from your Assignar account.
- Log in to Assignar and go to Settings → API Access in the left-hand navigation. Copy your Client ID and Client Secret, and paste them into the config file where it indicates "paste-your-client-id-here" and "paste-your-client-secret-here"
{
"mcpServers": {
"assignar": {
"command": "npx",
"args": [
"mcp-remote","https://mcp.assignar.com/api/mcp",
"--header",
"X-Assignar-Client-Id:<paste-your-client-id-here>",
"--header",
"X-Assignar-Client-Secret:<paste-your-client-secret-here>",
"--header",
"X-Assignar-Region:na"
]
}
}
}
Step 2 Verify Node.js is installed
- Open Terminal and run the following command to confirm you have Node v18 or higher:
- node --version
✓ You should see something like v24.14.0 — any v18+ is fine
Step 3 Fully quit and reopen Claude Desktop
- Save the config file, then quit Claude Desktop completely — use Cmd+Q, not just closing the window. Then reopen it.
✓ Claude Desktop should open without showing any error notifications.
Step 4 Verify the connection
- Open a new chat in Claude Desktop and ask: What tools do you have available from Assignar?
✓ Claude should respond with a list of 90+ Assignar tools covering workers, projects, timesheets, orders, payroll, and more.
Troubleshooting
Q Claude Desktop shows an error on startup
A Double-check your JSON syntax in the config file — a missing comma or bracket is the most common
cause. Use a JSON validator if unsure.
Q No Assignar tools appear in chat
A Make sure you fully quit Claude Desktop with Cmd+Q and relaunched it. Simply closing the window
doesn't reload the config.
Q npx command not found
A Node.js may not be in your PATH. Try installing it from nodejs.org or via Homebrew: brew install node
Q Authentication errors / tools return no data
A Verify your Client ID and Client Secret are correct and haven't expired. Regenerate them in Assignar
under Settings → API if needed.