# Maintainly MCP by usefulapi

> Maintainly MCP by usefulapi is an MCP server. List maintenance tasks, set task assignees, comment on tasks and report work requests in Maintainly. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

List maintenance tasks, set task assignees, comment on tasks and report work requests in Maintainly.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `maintainly_get_me`: Return the signed-in user and every profile this token reaches, with each organisation's route key. Use it to find the organisation key.
- `maintainly_list_tasks`: List maintenance tasks in the organisation, newest first. Filter with GitHub-style terms, such as status:open, type:reactive or due:<2026-12-31.
- `maintainly_get_task`: Return one task in full: assignees, work logs, materials, downtimes, checklists and its work request.
- `maintainly_list_task_assignment`: List the users assigned to a task and the users not assigned. Use the user guids here with maintainly_assign_task.
- `maintainly_list_work_requests`: List work requests (problems reported for an asset or location), with their status and the task raised from each. Filter with GitHub-style terms.
- `maintainly_get_work_request`: Return one work request with its description, reporter details, files and linked task.
- `maintainly_assign_task`: Set the assignees of a task to exactly these users. Send every user who should stay assigned, because the request sets the full list. Get guids from maintainly_list_task_assignment.
- `maintainly_add_task_comment`: Post a comment on a task. The comment is visible to everyone who can see the task.
- `maintainly_create_work_request`: Create a work request that reports a problem. It starts as open and can become a task after review.

## FAQ

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

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

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