# Gripp MCP by usefulapi

> Gripp MCP by usefulapi is an MCP server. Read projects, invoices, hours and contacts; register hours, create tasks in Gripp. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Read projects, invoices, hours and contacts; register hours, create tasks in Gripp.

## Install

### Claude Code (Terminal)

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

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

```sh
https://gripp.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "gripp": {
      "url": "https://gripp.usefulapi.io/mcp"
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "gripp": {
      "serverUrl": "https://gripp.usefulapi.io/mcp"
    }
  }
}
```

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

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

## Tools

- `gripp_list_companies`: List companies in Gripp. Companies (customers, suppliers, prospects) with address, VAT/COC numbers, customer number and active flag. Supports filters, paging (max 250 per call) and ordering. Gripp API: company.get.
- `gripp_list_contacts`: List contacts in Gripp. Contact persons with name, e-mail, phone, function and the company id. Supports filters, paging (max 250 per call) and ordering. Gripp API: contact.get.
- `gripp_list_projects`: List projects in Gripp. Projects with name, number, phase, company, account manager, dates, totals and archived flag. Supports filters, paging (max 250 per call) and ordering. Gripp API: project.get.
- `gripp_list_tasks`: List tasks in Gripp. Tasks with description, phase, deadline, estimated hours, company and completion state. Supports filters, paging (max 250 per call) and ordering. Gripp API: task.get.
- `gripp_list_hours`: List hours in Gripp. Time registrations (hours) with date, amount, employee, task, status and description. Supports filters, paging (max 250 per call) and ordering. Gripp API: hour.get.
- `gripp_list_invoices`: List invoices in Gripp. Sales invoices with number, date, status, company, totals, amount paid and open amount. Supports filters, paging (max 250 per call) and ordering. Gripp API: invoice.get.
- `gripp_list_offers`: List offers in Gripp. Quotes (offers) with number, name, date, phase, company, totals and acceptance status. Supports filters, paging (max 250 per call) and ordering. Gripp API: offer.get.
- `gripp_list_employees`: List employees in Gripp. Employees with name, e-mail, function, department, role and active flag. Supports filters, paging (max 250 per call) and ordering. Gripp API: employee.get.
- `gripp_list_tags`: List tags in Gripp. Tags that Gripp uses to label companies, contacts, projects and invoices. Supports filters, paging (max 250 per call) and ordering. Gripp API: tag.get.
- `gripp_get_record`: Get one Gripp record by its numeric id, for companies, contacts, projects, tasks, hours, invoices, offers, employees or invoice lines. Gripp API: <entity>.getone.
- `gripp_list_invoice_lines`: List invoice lines (description, amount, price, VAT) for one invoice id. Use this to see what an invoice contains. Gripp API: invoiceline.get.
- `gripp_create_hour`: WRITE: register hours on a project (and optionally a task) in Gripp. Creates a new time registration each call; a repeat creates a duplicate. Status CONCEPT keeps it editable. Gripp API: hour.create.
- `gripp_create_task`: WRITE: create a task in Gripp. Creates a new task each call; a repeat creates a duplicate. Gripp API: task.create.
- `gripp_create_contact`: WRITE: create a contact person on a company in Gripp. Creates a new contact each call; a repeat creates a duplicate. Gripp API: contact.create.

## FAQ

### How do I add Gripp MCP by usefulapi to Claude Code?

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

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