# Teamleader Focus MCP by usefulapi

> Teamleader Focus MCP by usefulapi is an MCP server. Read Teamleader Focus contacts, companies, deals, invoices, projects; create deals, tasks. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/teamleader-focus/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/teamleader-focus
- **MCP Registry name:** io.usefulapi/teamleader-focus
- **Listing updated:** 2026-11-13

## About

Read Teamleader Focus contacts, companies, deals, invoices, projects; create deals, tasks.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http teamleader-focus https://teamleader-focus.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://teamleader-focus.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "teamleader-focus": {
      "url": "https://teamleader-focus.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "teamleader-focus": {
      "type": "http",
      "url": "https://teamleader-focus.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "teamleader-focus": {
      "serverUrl": "https://teamleader-focus.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "teamleader-focus": {
      "type": "http",
      "url": "https://teamleader-focus.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `teamleader_create_invoice_drafts`: WRITE: preview up to five invoice drafts from zero-based quotation group/line positions. Full lines only, no repeated lines or recurring items. After approval, confirm with preview_hash and a stable operation_id; creates up to batch_size drafts per call with persistent duplicate protection. Preserves source prices, taxes, customer, currency and percentage discounts; shows vendor totals for review.
- `teamleader_invoice_draft_operation_status`: Read persistent batch progress and known invoice IDs. Uncertain writes are not replayed. This does not create, book or send invoices.
- `teamleader_get_current_user`: Fetch the Teamleader user the sign-in belongs to: name, email, account id, language, time zone and teams. A cheap way to confirm the connection works. Teamleader: users.me.
- `teamleader_list_users`: List the users (colleagues) in the Teamleader account. Use it to find a user id to assign deals or tasks to. Teamleader: users.list.
- `teamleader_list_contacts`: List or search contacts (people). Filter by search term, primary email, linked company, tags, status or last update. Teamleader: contacts.list.
- `teamleader_get_contact`: Fetch one contact in full: emails, telephones, addresses, linked companies (with position), tags, custom fields and remarks. Teamleader: contacts.info.
- `teamleader_list_companies`: List or search companies (organisations). Filter by search term, primary email, VAT number, tags, status or last update. Teamleader: companies.list.
- `teamleader_get_company`: Fetch one company in full: addresses, VAT number, responsible user, related contacts and companies, tags, custom fields and remarks. Teamleader: companies.info.
- `teamleader_list_deals`: List or search deals (sales opportunities). Filter by customer, phase, pipeline, status, responsible user, expected closing date or last update. Teamleader: deals.list.
- `teamleader_get_deal`: Fetch one deal in full: lead (customer + contact person), value, probability, current phase, phase history, linked quotations, responsible users, lost reason and custom fields. Teamleader: deals.info.
- `teamleader_list_deal_pipelines`: List the sales pipelines; the reply's meta names the default pipeline. Use a pipeline id with teamleader_list_deal_phases. Teamleader: dealPipelines.list.
- `teamleader_list_deal_phases`: List the phases (stages) of deal pipelines, in flow order, with their probability. Use a phase id when creating a deal. Teamleader: dealPhases.list.
- `teamleader_list_invoices`: List or search outgoing invoices. Filter by term, invoice number, status (draft / outstanding / matched = paid), customer, deal, project, invoice date range or last update. Returns totals, due date and paid state. Teamleader: invoices.list.
- `teamleader_get_invoice`: Fetch one invoice in full: invoicee, grouped line items, discounts, totals and taxes, payment term, payments received, payment reference and Peppol status. Teamleader: invoices.info.
- `teamleader_list_projects`: List projects (the projects module). Filter by term, status, customer or deal. Returns budget, time tracked, billed/unbilled amounts, dates and owners. Teamleader: projects-v2/projects.list.
- `teamleader_list_tasks`: List tasks (to-dos). Filter by assigned user, completed, scheduled, due date range, search term or customer. Teamleader: tasks.list.
- `teamleader_list_time_tracking`: List tracked time entries: who, when, duration (seconds), work type, subject, invoiceable flag and hourly rate. Filter by user, start range or subject. Teamleader: timeTracking.list.
- `teamleader_list_tickets`: List support tickets: subject, status, assignee, customer, project and last message time. Filter by customer, project or assignee. Teamleader: tickets.list.
- `teamleader_list_work_types`: List work types (e.g. Design, Development), alphabetically. A work type id is REQUIRED to create a task. Teamleader: workTypes.list.
- `teamleader_list_departments`: List the account's departments (company entities that issue invoices and quotations). A department id is needed to filter subscriptions and product categories or to create a deal for a specific entity. Teamleader: departments.list.
- `teamleader_list_products`: List or search products (the price list) by name or code. Teamleader: products.list.
- `teamleader_get_product`: Fetch one product in full: code, description, purchase and selling prices, tax rate, unit, stock and category. Teamleader: products.info.
- `teamleader_list_product_categories`: List the product categories (each one is a ledger account), optionally for one department. Teamleader: productCategories.list.
- `teamleader_list_quotations`: List quotations (offers) with their status, totals and deal. Teamleader filters quotations only by id: to find a deal's quotations, take the ids from teamleader_get_deal. Teamleader: quotations.list.
- `teamleader_get_quotation`: Fetch one quotation in full: deal, grouped line items, discounts, totals, taxes, status and expiry. Teamleader: quotations.info.
- `teamleader_list_activity_types`: List the activity types of calendar events (Teamleader has three: tasks, meetings and calls). An activity type id is REQUIRED to create a calendar event. Teamleader: activityTypes.list.
- `teamleader_list_events`: List calendar events (meetings, calls) in a time window. Filter by user, activity type, search term, an attending contact, a linked contact / company / deal, a task or done state. Teamleader: events.list.
- `teamleader_list_subscriptions`: List subscriptions (recurring invoices): title, status, customer, billing cycle and next invoice date. Filter by customer, deal, department, status or the invoice a subscription generated. Teamleader: subscriptions.list.
- `teamleader_get_subscription`: Fetch one subscription in full: invoicee, line items, totals, billing cycle, start and end dates and payment term. Teamleader: subscriptions.info.
- `teamleader_list_notes`: List the notes on one contact, company, deal, invoice, quotation, project and more, with their text and date. Teamleader: notes.list.
- `teamleader_create_contact`: WRITE: create a new contact (person) in Teamleader. Only last_name is required. Returns the new contact's id. Teamleader: contacts.add.
- `teamleader_create_company`: WRITE: create a new company in Teamleader. Only name is required. Returns the new company's id. Teamleader: companies.add.
- `teamleader_create_deal`: WRITE: create a new deal for an existing contact or company. Requires the customer and a title; optionally a phase (see teamleader_list_deal_phases), value, probability and expected closing date. Returns the new deal's id. Teamleader: deals.create.
- `teamleader_create_task`: WRITE: create a task (to-do). Requires a title, a due date and a work type id (see teamleader_list_work_types). Optionally assign it to a user or team and link a customer, deal, project or ticket. Returns the new task's id. Teamleader: tasks.create.
- `teamleader_add_note`: WRITE: add a note to a contact, company, deal, invoice, quotation, project and more, e.g. a call summary. Optionally notify colleagues. Returns the new note's id. Teamleader: notes.create.
- `teamleader_create_event`: WRITE: put a meeting or call on the Teamleader calendar. Requires a title, an activity type id (see teamleader_list_activity_types), a start and an end. Attendees are firm users only; link the customer or deal with links. Returns the new event's id. Teamleader: events.create.
- `teamleader_complete_task`: WRITE: mark a task (to-do) as complete. It can be reopened in Teamleader. Teamleader: tasks.complete.
- `teamleader_add_time_tracking`: WRITE: record time spent, e.g. 90 minutes of development for a company. Give started_at plus duration_minutes or ended_at; optionally a work type, a description, the subject (customer, ticket, task, ...) and whether it is invoiceable. Teamleader splits an entry that passes midnight. Returns the new entry's id. Teamleader: timeTracking.add.

## FAQ

### How do I add Teamleader Focus MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http teamleader-focus https://teamleader-focus.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/teamleader-focus-mcp-by-usefulapi
