teamleader-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@teamleader-mcp List all open deals for Acme Corporation"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
What is this?
A Model Context Protocol (MCP) server that connects AI assistants like Claude to Teamleader Focus - the all-in-one CRM, invoicing, and project management platform.
Instead of clicking through menus, just ask:
"Find all open deals for Acme Corporation"
"Create an invoice for 20 hours of consulting at ā¬125/hour"
"Schedule a meeting with Sarah from TechStart next Tuesday at 2pm"
"Log 3 hours to the website project with description: frontend development"Related MCP server: aha-mcp
Screenshots
Description | Image |
Claude Desktop with deal lookup |
|
Invoice creation conversation |
|
Multi-step workflow example |
|
Claude Desktop config |
|
Features
š¢ CRM
Companies - List, search, create, and update companies
Contacts - Full contact management with company linking
Deals - Pipeline management, move phases, win/lose tracking
š° Finance
Invoices - Draft, send, book, register payments
Quotations - Create, send, accept, download PDFs
Products - Product catalog management
ā±ļø Operations
Time Tracking - Log hours, manage entries, billable tracking
Calendar Events - Create and manage meetings linked to contacts/deals
Email Tracking - Log emails to entities
š Security
OAuth 2.0 with automatic token refresh
Secure credential storage
Rate limiting respect
Quick Start
1. Authenticate with Teamleader
npx teamleader-mcp authThis opens a browser for OAuth login. Your credentials are saved automatically.
2. Configure Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"teamleader": {
"command": "npx",
"args": ["-y", "teamleader-mcp"]
}
}
}3. Start Using!
Restart Claude Desktop and ask: "What Teamleader tools do you have access to?"
Installation
Prerequisites
Node.js 18 or higher
A Teamleader Focus account
OAuth 2.0 credentials from Teamleader Marketplace
Via npx (Recommended)
No installation needed - runs directly:
npx teamleader-mcp auth # One-time OAuth setup
npx teamleader-mcp # Start the MCP serverGlobal Install
npm install -g teamleader-mcp
teamleader-mcp authFrom Source
git clone https://github.com/Weichie-com/teamleader-mcp.git
cd teamleader-mcp
npm install
npm run buildOAuth Setup
1. Register Your Integration
Go to Teamleader Marketplace
Create a new integration
Note your
client_idandclient_secretSet redirect URI:
http://localhost:3000/callbackRequired scopes:
contacts,companies,deals,invoices,products,timetracking,events,users
2. Generate Tokens
The easiest way:
node scripts/generate-token.jsOr manually via OAuth authorization code flow - see OAUTH_CLAUDE_SETUP.md.
3. Configure Environment
cp .env.example .envEdit .env:
TEAMLEADER_ACCESS_TOKEN=your_access_token
TEAMLEADER_CLIENT_ID=your_client_id
TEAMLEADER_CLIENT_SECRET=your_client_secret
TEAMLEADER_REFRESH_TOKEN=your_refresh_tokenTools
This server provides 42 tools across all major Teamleader Focus features:
Companies (4 tools)
Tool | Description |
| List/search companies |
| Get company details |
| Create a company |
| Update a company |
Contacts (2 tools)
Tool | Description |
| List/search contacts |
| Get contact details |
Deals (7 tools)
Tool | Description |
| List deals with filters |
| Get deal details |
| Create a deal |
| Update a deal |
| Move to different phase |
| Mark as won |
| Mark as lost |
Invoices (7 tools)
Tool | Description |
| List invoices |
| Get invoice details |
| Create draft invoice |
| Update invoice |
| Send via email |
| Book/finalize |
| Register payment |
| Delete invoice |
Quotations (7 tools)
Tool | Description |
| List quotations |
| Get quotation details |
| Create quotation |
| Update quotation |
| Send via email |
| Mark as accepted |
| Delete quotation |
| Get PDF link |
Products (4 tools)
Tool | Description |
| List products |
| Get product details |
| Create product |
| Update product |
Time Tracking (5 tools)
Tool | Description |
| List time entries |
| Get entry details |
| Add time entry |
| Update entry |
| Delete entry |
Calendar Events (3 tools)
Tool | Description |
| List events |
| Get event details |
| Create event |
Email Tracking (2 tools)
Tool | Description |
| List tracked emails |
| Log an email |
Examples
Natural Language ā Actions
"Find all open deals worth more than ā¬10,000"
ā teamleader_deals_list(status: ["open"])
ā Filters results by value"Create an invoice for Acme Corp: 20 hours consulting at ā¬125/hour, 30 days payment term"
ā teamleader_companies_list(term: "Acme Corp")
ā teamleader_invoice_draft(customer_id: "...", grouped_lines: [...])"Schedule a meeting with John from DataFlow next Tuesday at 2pm"
ā teamleader_contacts_list(term: "John DataFlow")
ā teamleader_event_create(title: "Meeting", starts_at: "...", contact_ids: [...])Direct Tool Calls
# List open deals
mcporter call teamleader.teamleader_deals_list status='["open"]'
# Get company info
mcporter call teamleader.teamleader_company_info id="uuid-here"
# Create a time entry
mcporter call teamleader.teamleader_timetracking_add \
started_at="2026-01-31T09:00:00+01:00" \
ended_at="2026-01-31T12:00:00+01:00" \
description="Development work"Configuration Options
Environment Variables
Variable | Required | Description |
| Yes | OAuth access token |
| No* | OAuth client ID |
| No* | OAuth client secret |
| No* | OAuth refresh token |
| No | Custom token storage path |
*Required for automatic token refresh (recommended)
Token Refresh Modes
Static Mode: Only ACCESS_TOKEN set. Token expires after 1 hour. Manual refresh needed.
Auto Refresh Mode (Recommended): All four OAuth variables set. Tokens refresh automatically 5 minutes before expiry.
Troubleshooting
Make sure your config includes the args array:
{
"command": "node",
"args": ["/path/to/teamleader-mcp/dist/index.js"] // ā Required!
}Tool names are prefixed with teamleader_. Use teamleader_deal_info, not get-deal.
Run mcporter list teamleader to see all tools.
Access tokens expire after 1 hour. Set up automatic refresh with all OAuth variables, or manually refresh your token.
Teamleader allows 200 requests/minute. The server respects rate limit headers. Wait and retry, or reduce request frequency.
Development
# Build
npm run build
# Watch mode
npm run dev
# Test
npm test # Watch mode
npm run test:run # Single run
# Lint
npm run lintContributing
We welcome contributions! Here's how to help:
Bug Reports & Feature Requests
Open an issue with a clear description
Include steps to reproduce for bugs
For features, explain the use case
Pull Requests
Fork the repository
Create a feature branch:
git checkout -b feature/amazing-featureMake your changes
Run tests:
npm testCommit:
git commit -m 'Add amazing feature'Push:
git push origin feature/amazing-featureOpen a Pull Request
Code Style
TypeScript with strict mode
Prettier for formatting
ESLint for linting
Descriptive commit messages
Adding New Tools
Add the tool definition in
src/tools/Implement the handler
Add tests in
tests/Update this README
Roadmap
npm package publication
Project management tools (milestones, tasks)
Webhook support for real-time updates
Batch operations
More filter options
Credit notes support
See ROADMAP.md for details.
Related Resources
License
MIT License - see LICENSE file.
Acknowledgments
Built with ā¤ļø using the Model Context Protocol by Anthropic.
Available Tools
42 toolsteamleader_companies_listB
List companies from Teamleader Focus. Can filter by name, VAT number, or tags.
Inputs: tags, term, status, vat_number, +1 more.
teamleader_company_createA
Create a new company in Teamleader Focus.
Inputs: name (required), tags, emails, website, +3 more.
teamleader_company_infoA
Get details of a specific company by ID.
Inputs: id (required).
teamleader_company_updateB
Update an existing company in Teamleader Focus.
Inputs: id (required), name, tags, vat_number.
teamleader_contact_infoA
Get details of a specific contact by ID, including linked companies.
Inputs: id (required).
teamleader_contacts_listB
List contacts from Teamleader Focus. Can filter by name, email, company, or tags.
Inputs: tags, term, status, company_id.
teamleader_deal_createB
Create a new deal/opportunity in Teamleader Focus.
Inputs: title (required), customer_id (required), customer_type (required), summary, +5 more.
teamleader_deal_infoA
Get details of a specific deal by ID.
Inputs: id (required).
teamleader_deal_loseB
Mark a deal as lost.
Inputs: id (required), reason_id, extra_info.
teamleader_deal_moveA
Move a deal to a different phase.
Inputs: id (required), phase_id (required).
teamleader_deals_listA
List deals/opportunities from Teamleader Focus. Can filter by status, customer, or phase.
Inputs: term, status, phase_id, customer_id, +2 more.
teamleader_deal_updateB
Update an existing deal in Teamleader Focus.
Inputs: id (required), title, summary, estimated_value, +1 more.
teamleader_deal_winA
Mark a deal as won.
Inputs: id (required).
teamleader_emails_listA
List tracked emails from Teamleader Focus. REQUIRED: Both subject_type and subject_id must be provided to filter by linked entity.
Inputs: subject_id (required), subject_type (required).
teamleader_email_trackA
Track/log an email in Teamleader Focus. Links the email to a contact, company, or deal.
Inputs: to (required), body (required), from (required), subject (required), +2 more.
teamleader_event_createB
Create a new calendar event in Teamleader Focus.
Inputs: title (required), ends_at (required), starts_at (required), deal_ids, +6 more.
teamleader_event_infoA
Get details of a specific calendar event by ID.
Inputs: id (required).
teamleader_events_listA
List calendar events from Teamleader Focus. Can filter by date range, contact, company, or deal.
Inputs: to, from, deal_id, user_id, +2 more.
teamleader_invoice_bookA
Book a draft invoice (finalize it).
Inputs: id (required), on (required).
teamleader_invoice_deleteA
Delete a draft invoice or the last booked invoice.
Inputs: id (required).
teamleader_invoice_draftB
Create a new draft invoice in Teamleader Focus.
Inputs: customer_id (required), customer_type (required), department_id (required), grouped_lines (required), +3 more.
teamleader_invoice_infoA
Get details of a specific invoice by ID.
Inputs: id (required).
teamleader_invoice_register_paymentB
Register a payment for an invoice.
Inputs: id (required), amount (required), paid_at (required), currency.
teamleader_invoice_sendB
Send an invoice via email.
Inputs: id (required), to (required), body (required), subject (required).
teamleader_invoices_listA
List invoices from Teamleader Focus. Can filter by status, customer, or date. Returns max 100 per page.
Inputs: term, status, page_size, customer_id, +4 more.
teamleader_product_createA
Create a new product in Teamleader Focus.
Inputs: name (required), code, currency, description, +2 more.
teamleader_product_infoA
Get details of a specific product by ID.
Inputs: id (required).
teamleader_products_listB
List products from Teamleader Focus.
Inputs: term, updated_since.
teamleader_product_updateB
Update an existing product in Teamleader Focus.
Inputs: id (required), code, name, description, +1 more.
teamleader_quotation_acceptC
Mark a quotation as accepted.
Inputs: id (required).
teamleader_quotation_createB
Create a new quotation in Teamleader Focus.
Inputs: deal_id (required), name, text, expiry, +2 more.
teamleader_quotation_deleteB
Delete a quotation.
Inputs: id (required).
teamleader_quotation_downloadA
Get a download link for a quotation PDF.
Inputs: id (required).
teamleader_quotation_infoA
Get details of a specific quotation by ID.
Inputs: id (required).
teamleader_quotation_sendB
Send a quotation via email.
Inputs: to (required), content (required), subject (required), language (required), +1 more.
teamleader_quotations_listB
List quotations from Teamleader Focus.
Inputs: ids.
teamleader_quotation_updateC
Update an existing quotation in Teamleader Focus.
Inputs: id (required), name, text, expiry, +2 more.
teamleader_timetracking_addB
Add a new time tracking entry in Teamleader Focus.
Inputs: ended_at (required), started_at (required), subject_id, description, +3 more.
teamleader_timetracking_deleteC
Delete a time tracking entry.
Inputs: id (required).
teamleader_timetracking_infoA
Get details of a specific time tracking entry by ID.
Inputs: id (required).
teamleader_timetracking_listB
List time tracking entries from Teamleader Focus.
Inputs: user_id, subject_id, subject_type, started_after, +1 more.
teamleader_timetracking_updateB
Update an existing time tracking entry.
Inputs: id (required), description, invoiceable.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogā¦
TDQS
Scored across 42 tools
Each tool follows a clear resource+action naming pattern, making purposes distinct. Potential overlaps like deal_move vs deal_update are differentiated by specific semantics. No two tools appear to do the same thing.
All tools use teamleader_<resource>_<action> consistently. List operations use plural resources while info operations use singular, a predictable pattern. Minor variation like add vs create is contextually appropriate.
At 42 tools, the server is heavily oversized, far exceeding the 25+ threshold. Even for a full CRM integration, the number introduces significant context overhead and suggests a lack of consolidation.
Multiple core entities have missing CRUD operations: contacts lack create/update/delete, events lack update/delete, products lack delete. While many modules are covered, these gaps are notable and will require workarounds.
Maintenance
Related MCP Connectors
Read Teamleader Focus contacts, companies, deals, invoices, projects; create deals, tasks.
Manage projects, tasks, time tracking, and team collaboration through natural language.
Create contacts, move deals, send proposals and invoices, read your inbox, from Claude or ChatGPT.
Connects AI assistants to TrackingTime for querying time entries, projects, tasks, customers, and team data using natural language.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to perform CRM operations like creating contacts, managing deals, and updating leads through natural language using the Model Context Protocol.4-
- AlicenseNot gradedqualityCmaintenanceEnables natural language interaction with Home Assistant for managing entities, automations, services, and dashboards via the Model Context Protocol.151 npmMIT
- AlicenseBqualityDmaintenanceEnables managing tasks, projects, schedules, users, comments, and more in Motion via natural language through the Model Context Protocol.10Apache 2.0
- AlicenseNot gradedqualityFmaintenanceEnables LLM agents to interact with Twenty CRM data through natural language, providing tools for managing contacts, companies, opportunities, tasks, and more via the Model Context Protocol.MIT