Teamleader Focus MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Teamleader Focus MCP or direct API to manage contacts, track projects, create invoices, and review deals through natural language.

Teamleader Focus logoTeamleader Focus
Oauth2

Teamleader Focus is a work management platform combining CRM, project management, and invoicing. It helps small businesses and freelancers manage customer work and billing in one place.

278 Tools

Try Teamleader Focus now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Teamleader Focus
Try asking
TOOLS

Supported Tools

Every Teamleader Focus action and event your agent gets out of the box.

Accept Quotation

Irreversibly mark a quotation as accepted.

Activity Type Legacy Identifier

Translates `meeting`, `call` and `task` into their respective activity type UUID.

Add Customer to Project

Add a customer to the project.

Add Deal to Project

Add a deal to the project.

Add External Party to Project

Add an external party to a project.

Add Internal Ticket Message

Adds an internal message to a ticket.

Add Owner to Project

Add a user as owner.

Add Quotation to Project

Add a quotation to the project.

Add Ticket Reply

Adds a message to a ticket.

Add To Group Project Line

Add an existing task or material to a group.

Approve Incoming Credit Note

Approve an incoming credit note.

Approve Incoming Invoice

Approve an incoming invoice.

Approve Receipt

Approve a receipt.

Assign Project

Assign a user or a team to a project.

Assign Project Group

Assign a user or a team to a group.

Assign Project Material

Assign a user or a team to a material.

Assign Project Task

Assign a user or a team to a task.

Book Invoice (Irreversible)

WARNING: Permanently book a draft invoice, assigning its official invoice number.

Bulk Delete Day Off

Deletes a list of days off for the given user.

Cancel Calendar Event for All Attendees

Cancel one Teamleader Focus calendar event for all attendees by UUID.

Close Project

Irreversibly close a project.

Complete Call

Irreversibly mark a call as complete.

Complete Meeting

Irreversibly mark a meeting as complete.

Complete Task

Mark a task as complete.

Copy Invoice

Creates a new draft invoice based on another invoice.

Create Call

Add a new call.

Create Closing Day

Adds a closing day for the account.

Create Company

Create a new company in Teamleader Focus, mutating the connected account.

Create Contact

Create a new contact in Teamleader Focus, mutating the connected account.

Create Custom Field Definition

Create a custom field definition.

Create Day Off Type

Create a new day off type.

Create Deal

Create a deal for a company or contact customer in Teamleader Focus.

Create Deal Phase

Create a new deal phase.

Create Deal Pipeline

Create a new deal pipeline.

Create Draft Invoice

Create an unbooked, unsent invoice draft for a customer in Teamleader Focus.

Create Draft Invoice From Quotation and Mark Deal Won

Create an unbooked, unsent invoice draft from a Teamleader Focus quotation.

Create Email Tracking Entry

Create a new email tracking.

Create Calendar Event

Create a calendar event in the connected Teamleader Focus account, mutating its external calendar.

Create Incoming Credit Note

Adds an incoming credit note.

Create Incoming Invoice

Adds an incoming invoice.

Create Note

Create a new note.

Create Partial Credit Note for Invoice (Irreversible)

WARNING: Create and book a partial credit note against selected invoice amounts.

Create Product

Create a product in Teamleader Focus using at least a name or code.

Create Project

Create a Teamleader Focus Projects v2 project.

Create Project Group

Create a group.

Create Project Material

Create a material.

Create Project Task

Create a task.

Create Quotation

Create a quotation.

Create Receipt

Adds a receipt.

Create Report Meeting

Creates a report for a meeting.

Create Reservation

Create a new reservation.

Create Recurring Invoice Subscription

Create a subscription that changes recurring invoice generation.

Create Task

Create a new task.

Create Ticket

Create a ticket.

Create Time Entry

Add tracked time using exactly one timing variant: `started_at` + `duration`, `started_at` + `ended_at`, or `started_on` + `duration`.

Credit Invoice (Irreversible)

WARNING: Create and book a full credit note against an invoice.

Deactivate Recurring Invoice Subscription

Deactivate a subscription and stop its future recurring invoice generation.

Delete Call

Permanently delete a call.

Delete Closing Day

Removes a closing day for the account.

Permanently Delete Company (Irreversible)

Permanently and irreversibly delete one Teamleader Focus company by UUID.

Permanently Delete Contact

Irreversibly and permanently delete one Teamleader Focus contact by UUID.

Delete Day Off Type

Delete a day off type.

Permanently Delete Deal (Irreversible)

Permanently and irreversibly delete one Teamleader Focus deal by UUID.

Delete Deal Phase

Permanently delete a deal phase, optionally migrating its deals to another phase.

Delete Deal Pipeline

Permanently delete a deal pipeline and migrate its phases and affected deals as specified.

Permanently Delete Draft Invoice (Irreversible)

Permanently and irreversibly delete one Teamleader Focus financial document by invoice UUID.

Delete File

Permanently delete a Teamleader Focus file.

Delete Incoming Credit Note

Deletes an incoming credit note.

Delete Incoming Invoice

Deletes an incoming invoice.

Delete Meeting

Permanently delete a meeting, removing it from the Teamleader calendar.

Delete Note

Delete a note.

Permanently Delete Product (Irreversible)

Permanently and irreversibly delete one Teamleader Focus product by UUID.

Delete Project, Tasks, and Time Tracking

Permanently delete one Teamleader Focus Projects v2 project together with its related tasks and time tracking.

Delete Project and Tasks, Preserve Time Tracking

Permanently delete one Teamleader Focus Projects v2 project and its related tasks while preserving and unlinking related time tracking.

Delete Project External Party

Delete an external party.

Delete Project Group

Delete a group.

Delete Project Material

Delete a material.

Delete Project, Preserve Tasks and Time Tracking

Permanently delete one Teamleader Focus Projects v2 project while preserving and unlinking its related tasks and time tracking.

Delete Project Task

Delete a task.

Delete Quotation

Permanently delete a quotation.

Delete Receipt

Deletes a receipt.

Delete Reservation

Permanently remove a Teamleader Focus reservation and its scheduled allocation.

Delete Task

Delete a task.

Delete Time Entry

Delete a tracked time.

Download Credit Note

Download a credit note in a specific format.

Download File

Download a Teamleader Focus file through Mercury's bounded file transport.

Download Invoice

Download an invoice in a specific format.

Download Quotation

Download a quotation in a specific format.

Duplicate Deal Pipeline

Create a new deal pipeline by duplicating an existing one.

Duplicate Project

Duplicate a project.

Duplicate Project Group

Duplicate a group and its entities, without any time trackings.

Duplicate Project Material

Duplicate a material.

Duplicate Project Task

Duplicate a task, without its time trackings.

Get Call

Get information about a call.

Get Cloud Platform Url

Fetch cloudPlatform url for type and id.

Get Company

Return full details for one Teamleader Focus company by UUID.

Get Contact

Return full details for one Teamleader Focus contact by UUID.

Get Credit Note

Get details for a single credit note

Get Current Timer

Get the current running timer.

Get Current User

Return the authenticated Teamleader Focus user for identity and user-ID resolution.

Get Custom Field Definition

Get info about a specific custom field definition.

Get Daily User Availability

Returns the daily availability for all users.

Get Deal

Return full details for one Teamleader Focus deal by UUID.

Get Department

Return full details for one Teamleader Focus department by UUID.

Get Calendar Event

Return full details for one Teamleader Focus calendar event by UUID.

Get File

Get details for a single file.

Get Incoming Credit Note

Get details for a single incoming credit note.

Get Incoming Invoice

Get details for a single incoming invoice.

Get Invoice

Return full details for one Teamleader Focus invoice by UUID.

Get Meeting

Get information about a meeting.

Get Order

Return details for one Teamleader Focus order by UUID, optionally including custom fields.

Get Plannable Item

Returns the info for a single plannable item, either by ID or source if the ID is unknown.

Get Product

Return full details for one Teamleader Focus product by UUID.

Get Project

Return full details for one Teamleader Focus Projects v2 project by UUID.

Get Project Group

Returns all the information for one group.

Get Project Material

Returns all the information for one material.

Get Projects v2 Status

Fetch which version of Projects the account is using.

Get Project Task

Returns all the information for one task.

Get Quotation

Get a quotation.

Get Receipt

Get details for a single receipt.

Get Subscription

Get details for a single subscription.

Get Task

Get information about a task.

Get Ticket

Get details for a single ticket.

Get Ticket Message

Gets the ticket message.

Get Time Entry

Get information about tracked time.

Get Total User Availability

Returns the total availability for all users.

Get User

Return full details for one Teamleader Focus user by UUID.

Id Legacy Identifier

Translates an ID from the deprecated API into a new UUID.

Import Day Off

Imports a list of days off for the given user.

Import Ticket Message

Imports an existing message to a ticket.

Link To Company Contact

Link a contact to a company.

List Activity Types

Get a list of all activity types.

List Bookkeeping Submissions

List bookkeeping submissions for one financial document.

List Business Types

Get the names of business types (legal structures) a company can have within a certain country, sorted alphabetically.

List Call Outcomes

Get a list of call outcomes.

List Calls

Get a list of calls.

List Closing Days

Returns information about closing days of the account

List Commercial Discounts

Get a list of commercial discounts.

List Companies

Return one page of companies matching optional IDs, search text, tags, or update time.

List Contacts

Return one page of contacts matching optional IDs, search text, tags, email, or update time.

List Credit Notes

List credit notes.

List Currency Exchange Rates

Get a list of exchange rates for a provided currency.

List Custom Field Definitions

Get a list of all the definitions of custom fields.

List Day Off Types

Returns a list of day off types for the account

List Deal Phases

Return deal phases for selecting a phase when creating or updating a deal.

List Deal Pipelines

Get a list of all deal pipelines.

List Deals

Return one page of deals matching optional customer, phase, owner, status, date, pipeline, or search filters.

List Deal Sources

Get a list of all deal sources, sorted alphabetically (on name).

List Departments

Return the account's departments for ID and currency lookup.

List Document Templates

Get a list of all document templates.

List Email Tracking Entries

Get a list of all email tracking.

List Calendar Events

Return one page of calendar events matching optional date, attendee, link, or activity-type filters.

List Expenses

Get a list of all expenses.

List Files

Get a list of files.

List Invoices

Return one page of invoices matching optional customer, department, status, date, or payment filters.

List Level Two Areas

Get a list of level two areas (which correspond to provinces, departments or states in most countries).

List Lost Reasons

Get a list of lost reasons for deals.

List Mail Templates

Get a list of all mail templates.

List Meetings

Get a list of meetings.

List Notes

Get a list of all notes.

List Orders

Return one page of orders, optionally filtered by IDs.

List Payment Methods

Get a list of payment methods.

List Payments Incoming Credit Note

List payments for an incoming credit note.

List Payments Incoming Invoice

List payments for an incoming invoice.

List Payments Receipt

List payments for a(n incoming) receipt.

List Payment Terms

Get a list of available payment terms.

List Plannable Items

Lists all plannable items that match the optional filters provided.

List Price Lists

Get a list of priceLists.

List Product Categories

Return product categories used as accounting ledger accounts.

List Products

Return one page of products matching optional IDs, search text, or update time.

List Project Groups

Lists all the groups that match the optional filters provided.

List Project Lines

All line types (tasks, materials, groups) can be side-loaded.

List Project Materials

Lists all the materials that match the optional filters provided.

List Projects

Return one page of Projects v2 projects matching optional status, customer, deal, quotation, or search filters.

List Project Tasks

Lists all the tasks that match the optional filters provided.

List Quotations

Get a list of quotations.

List Reservations

Lists all reservations that match the optional filters provided.

List Subscriptions

Get a list of subscriptions.

List Tags

Get a list of tags.

List Tasks

Get a list of tasks.

List Tax Rates

Get a list of available tax rates.

List Teams

Gets a list of all teams.

List Ticket Messages

Lists messages of a ticket.

List Tickets

Get a list of tickets.

List Ticket Statuses

Get a list of ticket statuses.

List Time Entries

Get a list of tracked time.

List Units Of Measure

Get a list of units of measure.

List User Days Off

Returns information about days off of a given user.

List Users

Return one page of account users, optionally filtered by status or IDs.

List User Schedules

Returns the working schedules of one or more users, expanded per day over a date range of at most 7 days.

List Webhooks

List registered webhooks ordered by URL.

List Withholding Tax Rates

Get a list of available withholding tax rates.

List Work Types

Get a list of all work types, sorted alphabetically (on their name).

Lose Deal

Irreversibly mark a deal as lost and record the optional loss reason and extra information.

Mark As Default Deal Pipeline

Mark a pipeline as default.

Mark As Pending Review Incoming Credit Note

Mark an incoming credit note as pending review.

Mark As Pending Review Incoming Invoice

Mark an incoming invoice as pending review.

Mark As Pending Review Receipt

Mark a receipt as pending review.

Move Deal

Move the deal to a different phase.

Move Deal Phase

Move a phase to a new position in the pipeline.

Refuse Incoming Credit Note

Refuse an incoming credit note.

Refuse Incoming Invoice

Refuse an incoming invoice.

Refuse Receipt

Refuse a receipt.

Register Payment Incoming Credit Note

Register a payment for an incoming credit note.

Register Payment Incoming Invoice

Register a payment for an incoming invoice.

Register Invoice Payment (Financial Effect)

WARNING: Register a real payment against an invoice and change its payment state.

Register Payment Receipt

Register a payment for a(n incoming) receipt.

Register Webhook

Register a new webhook.

Remove Customer Project

Remove a customer from the project.

Remove Deal Project

Remove a deal from the project.

Remove From Group Project Line

Remove a task or material from the group it is currently in.

Remove Owner Project

Remove a user as owner.

Remove Payment Incoming Credit Note

Remove a payment from an incoming credit note.

Remove Payment Incoming Invoice

Remove a payment from an incoming invoice.

Remove Payment Receipt

Remove a payment from a receipt.

Remove All Invoice Payments (Irreversible)

WARNING: Remove every registered payment from an invoice and change its financial state.

Remove Quotation Project

Remove a quotation from the project.

Reopen Project

Reopen a closed project.

Reopen Task

Reopen a task that had been marked as complete.

Resume Time Entry

Start a new timer based on previously tracked time.

Schedule Meeting

Schedule a meeting.

Schedule Task

Schedule a task in your calendar.

Send Invoice to Recipients (External Effect)

WARNING: Send an invoice to external recipients immediately.

Send Quotation

Immediately email one or more quotations from the same deal to the supplied recipients.

Send To Bookkeeping Incoming Credit Note

Send an incoming credit note to bookkeeping.

Send To Bookkeeping Incoming Invoice

Send an incoming invoice to bookkeeping.

Send To Bookkeeping Receipt

Send a receipt to bookkeeping for processing.

Send Credit Note via Peppol (Irreversible External Effect)

WARNING: Transmit a credit note through the Peppol network.

Send Invoice via Peppol (Irreversible External Effect)

WARNING: Transmit an invoice through the Peppol network.

Start Timer

Start a new timer.

Stop Timer

Stop the current timer.

Tag Company

Add a new or existing tag to a company.

Tag Contact

Add a new or existing tag to a contact.

Tax Rate Legacy Identifier

Translates tax rates from the deprecated API into a new UUID tax rate.

Unassign Project

Unassign a user or a team from a project.

Unassign Project Group

Unassign a user or a team from a group.

Unassign Project Material

Unassign a user or a team from a material.

Unassign Project Task

Unassign a user or a team from a task.

Unlink From Company Contact

Unlink a contact from a company.

Unregister Webhook

Unregister a webhook.

Untag Company

Remove a tag from a company.

Untag Contact

Remove a tag from a contact.

Update Booked Invoice (Financial Effect)

WARNING: Modify an already booked financial document.

Update Call

Update the supplied fields of an existing call; omitted fields remain unchanged.

Update Company

Update only the supplied fields of an existing Teamleader Focus company.

Update Company Link Contact

Update contact to company link.

Update Contact

Update only the supplied fields of an existing Teamleader Focus contact.

Update Day Off Type

Update a day off type.

Update Deal

Update only the supplied fields of an existing Teamleader Focus deal without changing its lifecycle status.

Update Deal Phase

Update a deal phase.

Update Deal Pipeline

Update a single deal pipeline.

Update Draft Invoice

Update only a draft Teamleader Focus invoice.

Update Calendar Event

Update only the supplied fields of an existing Teamleader Focus calendar event.

Update Incoming Credit Note

Updates an incoming credit note.

Update Incoming Invoice

Updates an incoming invoice.

Update Meeting

Update a meeting.

Update Note

Update an existing note.

Update Payment Incoming Credit Note

Update a payment for an incoming credit note.

Update Payment Incoming Invoice

Update a payment for an incoming invoice.

Update Payment Receipt

Update a payment for a(n incoming) receipt.

Update Product

Update only the supplied fields of an existing Teamleader Focus product.

Update Project

Update only the supplied fields of an existing Teamleader Focus Projects v2 project.

Update Project External Party

Update an external party.

Update Project Group

Update a group.

Update Project Material

Update a material.

Update Project Task

Update a task.

Update Quotation

Update a quotation.

Update Receipt

Updates a receipt.

Update Reservation

Update an existing reservation.

Update Recurring Invoice Subscription

Update a subscription and its future recurring invoice generation.

Update Task

Update a task.

Update Ticket

Update a ticket.

Update Time Entry

Update tracked time.

Update Timer

Update the current timer.

Upload Avatar Contact

Update the avatar of a contact.

Upload File

Upload one file to Teamleader Focus through Mercury's bounded file transport.

Upload Logo Company

Update the logo of a company.

Win Deal

Irreversibly mark a deal as won.

SETUP GUIDE

Connect Teamleader Focus MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["teamleader"],
  mcp: true,
});
Create a session scoped to Teamleader Focus and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List my Teamleader Focus companies and show their names and email addresses.",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Teamleader Focus request
SETUP GUIDE

Connect Teamleader Focus API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["teamleader"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Teamleader Focus
3

Run Teamleader Focus tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List my Teamleader Focus companies and show their names and email addresses." }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Teamleader Focus tool calls through the session, and print the final answer

Why Use Composio?

AI Native Teamleader Focus Integration

  • Supports both Teamleader Focus MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Teamleader Focus data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Teamleader Focus access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Teamleader Focus
  • Scoped, least privilege access to Teamleader Focus resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Start with Teamleader Focus.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Teamleader Focus tool your agent needs.Free to start.

Start building