itcons-app avatar

Itcons.app

itcons-app/mcp

This server connects Claude to Itcons.app, a business operations platform for managing work orders, reports, projects, and field workflows. You get read access to catalogs like statuses, users, resources, and clients, plus search across work reports and orders. On the write side, you can create clients, projects, users, and work orders when your account has permission. It runs locally via stdio for Claude Desktop or as a remote HTTPS endpoint with OAuth for hosted clients like ChatGPT. The remote mode includes a reports-only profile if you want to expose just work report queries publicly. Authentication uses either username and password or an existing bearer token against your Itcons.app subdomain.

tools
43
auth
Secret needed
transport
STDIO, HTTP, SSE
env vars
5
last updated
Apr 21, 2026

Tools

43 tools

Public tool metadata for what this MCP can expose to an agent.

itcons_check_connectionRead-only tools:

Read-only tools:

No parameter schema in public metadata yet.

itcons_list_users

No parameter schema in public metadata yet.

itcons_get_user

No parameter schema in public metadata yet.

itcons_list_clients

No parameter schema in public metadata yet.

itcons_get_client

No parameter schema in public metadata yet.

itcons_list_projects

No parameter schema in public metadata yet.

itcons_get_project

No parameter schema in public metadata yet.

itcons_list_categories

No parameter schema in public metadata yet.

itcons_get_category

No parameter schema in public metadata yet.

itcons_list_resources

No parameter schema in public metadata yet.

itcons_get_resource

No parameter schema in public metadata yet.

itcons_list_calendars

No parameter schema in public metadata yet.

itcons_get_calendar

No parameter schema in public metadata yet.

itcons_list_leave_types

No parameter schema in public metadata yet.

itcons_list_work_report_templates

No parameter schema in public metadata yet.

itcons_get_work_report_template

No parameter schema in public metadata yet.

itcons_list_work_reports

No parameter schema in public metadata yet.

itcons_get_work_report

No parameter schema in public metadata yet.

itcons_get_work_report_as_post_payload

No parameter schema in public metadata yet.

itcons_list_work_reports_by_date

No parameter schema in public metadata yet.

itcons_list_today_work_reports

No parameter schema in public metadata yet.

itcons_list_work_order_types

No parameter schema in public metadata yet.

itcons_get_work_order_type

No parameter schema in public metadata yet.

itcons_list_work_orders

No parameter schema in public metadata yet.

itcons_get_work_order

No parameter schema in public metadata yet.

itcons_list_statuses

No parameter schema in public metadata yet.

itcons_create_user

No parameter schema in public metadata yet.

itcons_update_user

No parameter schema in public metadata yet.

itcons_create_client

No parameter schema in public metadata yet.

itcons_update_client

No parameter schema in public metadata yet.

itcons_create_project

No parameter schema in public metadata yet.

itcons_update_project

No parameter schema in public metadata yet.

itcons_create_category

No parameter schema in public metadata yet.

itcons_update_category

No parameter schema in public metadata yet.

itcons_create_resource

No parameter schema in public metadata yet.

itcons_update_resource

No parameter schema in public metadata yet.

itcons_create_work_report

No parameter schema in public metadata yet.

itcons_update_work_report_metadata

No parameter schema in public metadata yet.

itcons_replace_work_report_content

No parameter schema in public metadata yet.

itcons_create_work_order

No parameter schema in public metadata yet.

itcons_update_work_order

No parameter schema in public metadata yet.

itcons_list_work_report_models

No parameter schema in public metadata yet.

itcons_search_work_reports

No parameter schema in public metadata yet.

Sponsors

Configuration

ITCONS_DOMAIN*

Itcons.app tenant domain, for example 'demo' for https://demo.itcons.app.

ITCONS_USERNAME

Itcons.app username or email for local stdio usage.

ITCONS_PASSWORDsecret

Itcons.app password for local stdio usage.

ITCONS_TOKENsecret

Existing Itcons.app bearer token. Can be used instead of username and password.

ITCONS_TIMEZONEdefault: Europe/Madrid

Timezone used for date-based queries.

Readme

Itcons.app MCP Server

Model Context Protocol server for connecting AI assistants to Itcons.app API v3.

Itcons.app is a business operations platform for managing work reports, work orders, projects, clients, users, calendars, categories, and operational resources.

This package can run in two modes:

  • Local stdio mode for clients such as Codex, Claude Desktop, and other local MCP hosts.
  • Remote HTTP mode for hosted MCP clients or other clients that require a public HTTPS MCP endpoint.

The MCP uses the existing Itcons.app username/password login flow (POST /api/login_check) and then calls API v3 with Bearer authentication.

Features

  • Resolve the tenant from ITCONS_DOMAIN.
  • Call API v3 under https://{ITCONS_DOMAIN}.itcons.app/api/v3.
  • List and get users, clients, projects, categories, resources, calendars, leave types, work report templates, work reports, work order types, and work orders.
  • Create and patch API v3 users, clients, projects, categories, resources, work reports, and work orders.
  • Keep the existing reports-only HTTP profile at /reports-mcp for the current ChatGPT connector.

View the full README on GitHub

Details

Repository
github.com/itcons-app/mcp
Package
@itcons-app/mcp
Transport
STDIO, HTTP, SSE
Auth
Required
Registry
MCP registry, active