Skip to content
MCP server

HERO Software MCP by usefulapi

Read contacts, projects, documents and log entries, and run read-only queries in HERO…

Install
Runs
Remotely
Version
1.7.0
Listing updated
4 days ago

About HERO Software MCP by usefulapi

HERO Software MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Read contacts, projects, documents and log entries, and run read-only queries in HERO Software.

Install

Run in a terminal

claude mcp add --transport http hero-software https://hero-software.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://hero-software.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "hero-software": {
      "url": "https://hero-software.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "hero-software": {
      "type": "http",
      "url": "https://hero-software.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "hero-software": {
      "serverUrl": "https://hero-software.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "hero-software": {
      "type": "http",
      "url": "https://hero-software.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (5)

Read directly from the server.

hero_list_contacts
List contacts (customers and others) with number, name, company, email, phone and address. Filter by category (for example 'customer'). Page with offset. HERO GraphQL query: contacts.
hero_list_projects
List projects with project number, trade (measure), customer, contact person, project address and status. Pass ids to fetch only some projects. HERO GraphQL query: project_matches.
hero_get_project
Get one project by id with its customer documents (type, number, value, file link) and its history entries (log book). HERO GraphQL query: project_matches(ids).
hero_list_documents
List customer documents (offers, invoices and so on) with number, date, value, VAT, status, document type and file link. HERO GraphQL query: customer_documents.
hero_run_query
Run any read-only GraphQL query on the HERO API, for example calendar_events or supply_product_versions, or a schema introspection ({ __schema { queryType { fields { name } } } }). Mutations and subscriptions are refused. The schema is only visible by introspection with your key.

HERO Software MCP by usefulapi FAQ

How do I add HERO Software MCP by usefulapi to Claude Code?

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