HERO Software MCP server
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., "@HERO Software MCP server Search for Müller, create a contact and project, then draft a quote."
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.
HERO Software MCP server through Cotlet.dev
Connect HERO Software to ChatGPT, Claude, Codex and Claude Code through Cotlet.dev. Turn inquiries into contacts and projects, draft quotes, prepare invoices and brief your crew from the calendar.
This is an unofficial integration, not affiliated with HERO Software. Cotlet.dev hosts the connection through your own signed-in Cloud Browser. This repository provides an optional Python stdio MCP bridge.
Connect your account
Open https://login.hero-software.de in your Cotlet.dev Cloud Browser and sign in with your own HERO user. Enable HERO Software for agents.
Connect your agent. Refresh the connector if you enabled HERO after connecting.
ChatGPT
Open Settings > Apps & Connectors > Create. Enter https://cotlet.dev/mcp/v1/connect as the MCP server URL and choose OAuth.
Claude
Open Settings > Connectors > Add custom connector and enter https://cotlet.dev/mcp/v1/connect.
Codex
Create a Cotlet.dev API key in your console and set COTLET_API_KEY in your environment:
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"Claude Code
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"Related MCP server: Fast Estimate Maker MCP Server
Trade office workflows
Examples from the live HERO Software integration reference:
Search the customer index before creating a contact and project for a new inquiry.
Draft a quote using quantities, prices and VAT rates you provide.
Read an accepted quote, confirm creating its invoice, then separately approve emailing it.
Review overdue invoices and the project logbook before approving a payment reminder.
Brief the crew using appointments and open tasks.
Add site notes to a project logbook or create a calendar appointment.
The live reference lists 15 hosted capabilities: 7 read and 8 write, grouped under hero_software_read and hero_software_write:
list_projectsget_projectlist_contactscreate_contactcreate_projectadd_logbook_entrylist_documentsget_documentcreate_quotecreate_invoice_from_quotesend_documentsend_payment_reminderlist_appointmentslist_taskscreate_appointment
create_invoice_from_quote, send_document and send_payment_reminder ask for approval by default; this can be changed per tool. The other five writes change your HERO account immediately. Quotes and invoices stay in the project until send_document emails them. Prices come from you or your article data. Check recipients, totals and VAT before approving. Emailed documents cannot be recalled. Creating an appointment does not email the customer.
Optional local stdio bridge
Python 3.10 or newer is required, with no runtime dependencies. Clone this repository and configure a client that supports stdio:
{"mcpServers":{"hero-software":{"command":"python3","args":["/absolute/path/to/hero-software-mcp/hero_software_agent.py"],"env":{"COTLET_API_KEY":"your-cotlet-key"}}}}The bridge lists seven browser helpers: hero_software_guide, hero_software_status, hero_software_open, hero_software_read, hero_software_click, hero_software_type and hero_software_close. These forward to Cotlet.dev's shared browser tools; they are separate from the 15 hosted workflow capabilities. Call the guide first and close the browser when finished. Discovery works without a key. Execution requires your Cotlet.dev key and connected account.
python3 hero_software_agent.py connect
python3 hero_software_agent.py guide
python3 hero_software_agent.py status
python3 hero_software_agent.py serveYou can also build the included Dockerfile and pass COTLET_API_KEY as an environment variable.
Reference and access
Licensed under Elastic License 2.0. See LICENSE.
Available Tools
7 toolshero_software_clickB
Click a numbered element on the current HERO Software page.
Inputs: element (required).
hero_software_closeA
Close the HERO Software browser session when the work is done, so credits stop running.
Inputs: no named parameters.
hero_software_guideA
How to work in HERO Software (trade business projects, quotes, invoices and appointments): its screens and the sign-in link. Call this first.
Inputs: task.
hero_software_openA
Open a HERO Software page in your signed-in Cloud Browser (default https://login.hero-software.de) to work with trade business projects, quotes, invoices and appointments.
Inputs: url.
hero_software_readA
Read the current HERO Software page: its text and numbered buttons, links and fields.
Inputs: element.
hero_software_statusA
Check that your Cotlet.dev account and HERO Software are ready: account, credits and HERO Software connection.
Inputs: no named parameters.
hero_software_typeC
Type text into a numbered field on the current HERO Software page.
Inputs: text (required), element (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a clearly distinct role: guide explains the system, status checks account readiness, and open/read/click/type/close form a non-overlapping browser-action sequence. There is no confusion about which tool to pick for a given step.
All tools share the consistent hero_software_ prefix followed by a concise verb (open, read, click, type, close) or clearly labeled noun (guide, status). The snake_case convention is uniform throughout.
Seven tools is well-scoped for a browser-automation workflow, with each tool earning its place. No redundant or filler tools are present.
The surface covers the full browser lifecycle (open, read, click, type, close) plus onboarding (guide) and health (status). Minor gaps like scroll or explicit navigation beyond open are not covered but most workflows can work around them.
Maintenance
Related MCP Connectors
Lexware Office (lexoffice) MCP server for ChatGPT, Claude and any AI agent: create quote, create invoice, finalise invoice, upload receipt and add contact in your own Lexware Office (lexoffice) account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Lexware Office (lexoffice) yourself; Cotlet does not store your password and you need no Lexware Office (lexoffice) API key. About the official Lexware Office (lexoffice) API: Yes, Lexware Office has a public REST API with an API key (checked 14 Oct 2026). It covers quotes, order confirmations, invoices, contacts, file uploads, payments (read only) and webhooks, but only from version XL, and Lexware publishes no MCP server of its own. Setup and FAQ: https://cotlet.dev/integrations/lexware-office-api-mcp-server
sevdesk MCP server for ChatGPT, Claude and any AI agent: create invoice, send invoice, upload receipt, book voucher and list open invoices in your own sevdesk account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to sevdesk yourself; Cotlet does not store your password and you need no sevdesk API key. About the official sevdesk API: sevdesk has a REST API (checked 14 Oct 2026). It covers almost everything the web app does, but only on the Buchhaltung Pro plan, in Germany, on system version 2.0. Setup and FAQ: https://cotlet.dev/integrations/sevdesk-api-mcp-server
Accelo MCP server for ChatGPT, Claude and any AI agent: list tickets, reply to ticket, update ticket, log time, create task and create quote in your own Accelo account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Accelo yourself; Cotlet does not store your password and you need no Accelo API key. About the official Accelo API: Accelo has a full REST API and a hosted MCP server, but the MCP server is built for questions about your data (checked 17 Oct 2026). The API covers companies, contacts, tickets, projects, tasks, activities, quotes and invoices, and you register an OAuth application under Configuration > API to use it. Setup and FAQ: https://cotlet.dev/integrations/accelo-api-mcp-server
Teamleader MCP server for ChatGPT, Claude and any AI agent: list overdue invoices, send invoice reminder, list quotations, send quotation, move deal to a phase, create task, add note and search companies in your own Teamleader account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Teamleader yourself; Cotlet does not store your password and you need no Teamleader API key. About the official Teamleader API: Teamleader has a full public API, version 2, but no official MCP server (checked 20 Oct 2026). Each call is a POST such as companies.list or invoices.send. Setup and FAQ: https://cotlet.dev/integrations/teamleader-api-mcp-server
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables ChatGPT, Claude, and other AI agents to manage appointments, customers, services, staff calendars, and notes in Setmore through natural language via Cotlet.dev.7Elastic 2.0
- AlicenseNot gradedqualityCmaintenanceConnects AI agents to a signed-in contractor account through Cotlet.dev so they can work with estimates, leads, change orders, and job costs. Supports drafting line items, tracking estimate views, reading margins and recorded costs, and reviewing changes before writes are sent.Elastic 2.0
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to work with a signed-in Buildern contractor account through Cotlet.dev, including estimates, schedules, budgets, bills, client invoices, project to-dos, and site diaries, with review before write operations.Elastic 2.0
- AlicenseAqualityBmaintenanceConnects ChatGPT, Claude, Codex and Claude Code through Cotlet.dev to a signed-in construction management account, enabling work with projects, estimates, bids, change orders, daily logs, RFIs, invoices and related workflows. It exposes 31 read and write capabilities, most write actions requiring confirmation before anything is sent or changed.7Elastic 2.0