Simplicate MCP Server

# n8n MCP Simplicate - Quick Reference Guide ## 🚨 IMPORTANT: Exact Tool Names Required In n8n, you **MUST** use the exact tool name and JSON parameters. Natural language won't work! --- ## ✅ Working Tools (Copy & Paste These) ### 1️⃣ Get Absences ```json { "name": "get_absences", "arguments": { "limit": 50, "offset": 0 } } ``` ### 2️⃣ Get Employees ```json { "name": "get_employees", "arguments": { "limit": 100, "offset": 0 } } ``` ### 3️⃣ Get Hours ```json { "name": "get_hours", "arguments": { "limit": 100, "offset": 0 } } ``` ### 4️⃣ Get Leave (Vacation/Time Off) ```json { "name": "get_leave", "arguments": { "limit": 50, "offset": 0 } } ``` ### 5️⃣ Get Projects ```json { "name": "get_projects", "arguments": { "limit": 50, "offset": 0 } } ``` ### 6️⃣ Get Organizations ```json { "name": "get_organizations", "arguments": { "limit": 50, "offset": 0 } } ``` ### 7️⃣ Get Persons (Contacts) ```json { "name": "get_persons", "arguments": { "limit": 50, "offset": 0 } } ``` ### 8️⃣ Get Invoices ```json { "name": "get_invoices", "arguments": { "limit": 50, "offset": 0 } } ``` ### 9️⃣ Get Sales Quotes ```json { "name": "get_quotes", "arguments": { "limit": 50, "offset": 0 } } ``` ### 🔟 Get Timetable (Schedule) ```json { "name": "get_calendar_events", "arguments": { "limit": 50, "offset": 0 } } ``` ### 1️⃣1️⃣ Get Services ```json { "name": "get_services", "arguments": { "limit": 50, "offset": 0 } } ``` ### 1️⃣2️⃣ Get Documents ```json { "name": "get_documents", "arguments": { "limit": 50, "offset": 0 } } ``` ### 1️⃣3️⃣ Get Payments ```json { "name": "get_payments", "arguments": { "limit": 50, "offset": 0 } } ``` --- ## 🎯 Get Specific Items by ID ### Get Specific Employee ```json { "name": "get_employee", "arguments": { "employee_id": "employee:3b70f4dd49fafb356d44e34a3f0f8c3d" } } ``` ### Get Specific Project ```json { "name": "get_project", "arguments": { "project_id": "project:xxxxx" } } ``` ### Get Specific Organization ```json { "name": "get_organization", "arguments": { "organization_id": "organization:xxxxx" } } ``` ### Get Specific Invoice ```json { "name": "get_invoice", "arguments": { "invoice_id": "invoice:xxxxx" } } ``` --- ## 🔧 How to Use in n8n ### Method 1: AI Agent Node (Recommended) 1. Add **AI Agent** node 2. Connect to **Simplicate MCP** tool 3. In the prompt, be VERY specific: ``` Use the tool "get_absences" with arguments {"limit": 50, "offset": 0} ``` ### Method 2: Direct MCP Tool Call 1. Add **MCP** node 2. Select **Simplicate** server 3. **Tool Name:** `get_absences` (exact, no quotes) 4. **Arguments:** ```json { "limit": 50, "offset": 0 } ``` --- ## 🚨 Common Mistakes ### ❌ DON'T Say: - "Show me absences from Simplicate" - "Get absences" - "List all employees" - "Fetch hours" ### ✅ DO Say (in AI Agent): ``` Execute the tool "get_absences" with parameters: { "limit": 50, "offset": 0 } ``` Or even better, use the direct MCP node with exact tool names! --- ## 📋 Complete Tool List All 63+ tools are documented in `MCP_TOOL_REFERENCE.md`, but here are the most reliable ones: | Tool Name | What It Gets | Status | |-----------|-------------|--------| | `get_employees` | All employees | ✅ Working | | `get_absences` | Employee absences | ✅ Working | | `get_leave` | Vacation/leave | ✅ Working | | `get_hours` | Logged hours | ✅ Working | | `get_calendar_events` | Schedules/timetable | ✅ Working | | `get_projects` | All projects | ✅ Working | | `get_organizations` | CRM organizations | ✅ Working | | `get_persons` | CRM contacts | ✅ Working | | `get_quotes` | Sales quotes | ✅ Working | | `get_invoices` | Invoices | ✅ Working | | `get_payments` | Invoice payments | ✅ Working | | `get_services` | Services catalog | ✅ Working | | `get_documents` | Documents | ✅ Working | --- ## 🧪 Test Your Setup ### In n8n Workflow: 1. **Add MCP node** 2. **Server:** Select "Simplicate" 3. **Tool:** `get_absences` 4. **Arguments:** ```json { "limit": 10, "offset": 0 } ``` 5. **Execute** ✅ --- ## 💡 Pro Tips for n8n 1. **Always use exact tool names** - No natural language 2. **Always provide limit/offset** - Default is usually 10 3. **Use Code node for filtering** - Get all data, then filter in n8n 4. **Chain tools together** - Get employees → Filter → Get their hours --- ## 🎯 Example n8n Workflow: Get Dwayne's Absences ``` Step 1: Get All Absences ├─ MCP Node ├─ Tool: "get_absences" └─ Args: {"limit": 100, "offset": 0} Step 2: Filter for Dwayne ├─ Code Node └─ Filter items where employee.name contains "Dwayne" Step 3: Format Output ├─ Code Node └─ Create readable list ``` --- ## 📞 Need Help? - **Full API Reference:** See `MCP_TOOL_REFERENCE.md` - **Endpoint Status:** See `ENDPOINT_STATUS.md` - **Test Commands:** Run `npm run test:all` --- **Remember:** In n8n, the AI agent needs EXACT tool names, not natural language! 🎯