# HERO Software MCP by usefulapi

> HERO Software MCP by usefulapi is an MCP server. Read contacts, projects, documents and log entries, and run read-only queries in HERO Software. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

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

## Install

### Claude Code (Terminal)

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

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

```sh
https://hero-software.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "hero-software": {
      "url": "https://hero-software.usefulapi.io/mcp"
    }
  }
}
```

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

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

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

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

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

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

## Tools

- `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.

## 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

---
Source: https://ai-powered.com/mcp/hero-software-mcp-by-usefulapi
