# Cogmento MCP by usefulapi

> Cogmento MCP by usefulapi is an MCP server. Read Cogmento CRM contacts, companies, deals, tasks and cases; create records and complete tasks. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Read Cogmento CRM contacts, companies, deals, tasks and cases; create records and complete tasks.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `cogmento_get_current_user`: The Cogmento user this API token belongs to: id, name, email, timezone and account id. GET /auth/user/.
- `cogmento_get_account`: The Cogmento account: name, country, settings, billing plan, trial days left and number of users. GET /account/.
- `cogmento_get_templates`: The field definitions (names, labels, types, options) of the account's templates for each record type: contacts, companies, deals, cases, tasks. Use it to learn the custom field names for filters, creates and field updates. GET /templates/.
- `cogmento_list_contacts`: List or search contacts (name, email and phone channels, company). Filter on any field, e.g. first_name contains 'Eric'. GET /contacts/.
- `cogmento_get_contact`: One full contact record, including its related tasks, cases, calls, events and documents. GET /contacts/{id}/.
- `cogmento_create_contact`: WRITE: create a contact. Needs first and last name; email and phone are optional. POST /contacts/.
- `cogmento_list_companies`: List or search companies (name, website, contacts). GET /companies/.
- `cogmento_get_company`: One full company record with its contacts and related records. GET /companies/{id}/.
- `cogmento_create_company`: WRITE: create a company. POST /companies/.
- `cogmento_list_deals`: List or search deals (title, amount, close date, assigned users, products). GET /deals/.
- `cogmento_get_deal`: One full deal record with its contacts, products and related records. GET /deals/{id}/.
- `cogmento_create_deal`: WRITE: create a deal. POST /deals/.
- `cogmento_get_deal_pipeline_summary`: Totals by pipeline stage: how many deals sit at each stage and what they are worth. Optional filters narrow the deals counted. GET /deals/summary/.
- `cogmento_aggregate_deals`: Sums and counts deals grouped by a field (default grouping as Cogmento chooses; e.g. field=stage). GET /deals/aggregate/.
- `cogmento_list_deal_stages`: The account-wide stages a contact can be at within a deal (for example Champion or Decision maker). GET /deals/stages/.
- `cogmento_set_deal_contact_stage`: WRITE: record where a contact sits in a deal (a stage from cogmento_list_deal_stages). The contact is attached to the deal if it is not already. POST /deals/{id}/contact/{id}/stage/.
- `cogmento_list_tasks`: List or search tasks (title, due date, completion date, assigned users, linked deal/contact/case). Filter e.g. on due_date. GET /tasks/.
- `cogmento_get_task`: One task record. GET /tasks/{id}/.
- `cogmento_create_task`: WRITE: create a task. POST /tasks/.
- `cogmento_complete_task`: WRITE: mark a task complete, stamping who completed it and when. A recurring task also gets its next occurrence. POST /tasks/{id}/complete/.
- `cogmento_list_cases`: List or search cases (support or project cases: title, close date, assigned users, deal, company). GET /cases/.
- `cogmento_get_case`: One case record. GET /cases/{id}/.
- `cogmento_create_case`: WRITE: create a case. POST /cases/.
- `cogmento_list_products`: List the product catalogue (name, prices) that deals and invoices draw on. GET /products/.
- `cogmento_list_calls`: The account's call records, most recent first: logged manual calls and calls placed through the browser dialer. GET /calls/.
- `cogmento_update_record_field`: WRITE: change a single field of a contact, company, deal, task or case, e.g. a deal's status or a contact's first_name. Custom field names come from cogmento_get_templates. System fields (id, acl, private, timestamps) are refused. PATCH /<type>/{id}/.

## FAQ

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

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

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