holaspirit mcp server

Local 2025-08-31 23:47:47 0

Provides MCP-compatible access to Holaspirit's API, allowing AI assistants to interact with organizational data such as tasks, circles, roles, and meetings through a standardized interface.

A MCP(Model Context Protocol) server that accesses to Holaspirit API.

This server provides MCP-compatible access to Holaspirit's API, allowing AI assistants to interact with your Holaspirit data through a standardized interface.

Features

Available tools:

list_tasks - List all tasks in the organization
list_metrics - List all metrics in the organization
list_circles - List all circles in the organization
get_circle - Get details of a specific circle
list_roles - List all roles in the organization
get_role - Get details of a specific role
list_domains - List all domains in the organization
list_policies - List all policies in the organization
list_meetings - List all meetings in the organization
get_meeting - Get details of a specific meeting

Quick Start

Installation

Installing via Smithery

To install holaspirit-mcp-server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install holaspirit-mcp-server --client claude

Manual Installation

npm install holaspirit-mcp-server

Configuration

HOLASPIRIT_API_TOKEN: Your Holaspirit API token

Usage

Start the MCP server

Directly:

npx holaspirit-mcp-server

Or, run the installed module with node.

Edit MCP configuration json for your client:

...
    "lightdash": {
      "command": "npx",
      "args": [
        "-y",
        "holaspirit-mcp-server"
      ],
      "env": {
        "HOLASPIRIT_API_TOKEN": "<your token>"
      }
    },
...

Development

Available Scripts

npm run dev - Start the server in development mode with hot reloading
npm run build - Build the project for production
npm run start - Start the production server
npm run lint - Run linting checks (ESLint and Prettier)
npm run fix - Automatically fix linting issues
npm run examples - Run the example scripts

Contributing

Fork the repository
Create your feature branch
Run tests and linting: npm run lint
Commit your changes
Push to the branch
Create a Pull Request

[
  {
    "description": "List all tasks in the organization",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "organizationId": {
          "type": "string"
        }
      },
      "required": [
        "organizationId"
      ],
      "type": "object"
    },
    "name": "list_tasks"
  },
  {
    "description": "List all metrics in the organization",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "organizationId": {
          "type": "string"
        }
      },
      "required": [
        "organizationId"
      ],
      "type": "object"
    },
    "name": "list_metrics"
  },
  {
    "description": "List all circles in the organization",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "organizationId": {
          "type": "string"
        }
      },
      "required": [
        "organizationId"
      ],
      "type": "object"
    },
    "name": "list_circles"
  },
  {
    "description": "Get details of a specific circle",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "circleId": {
          "type": "string"
        },
        "organizationId": {
          "type": "string"
        }
      },
      "required": [
        "organizationId",
        "circleId"
      ],
      "type": "object"
    },
    "name": "get_circle"
  },
  {
    "description": "List all roles in the organization",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "organizationId": {
          "type": "string"
        }
      },
      "required": [
        "organizationId"
      ],
      "type": "object"
    },
    "name": "list_roles"
  },
  {
    "description": "Get details of a specific role",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "organizationId": {
          "type": "string"
        },
        "roleId": {
          "type": "string"
        }
      },
      "required": [
        "organizationId",
        "roleId"
      ],
      "type": "object"
    },
    "name": "get_role"
  },
  {
    "description": "List all domains in the organization",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "organizationId": {
          "type": "string"
        }
      },
      "required": [
        "organizationId"
      ],
      "type": "object"
    },
    "name": "list_domains"
  },
  {
    "description": "List all policies in the organization",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "organizationId": {
          "type": "string"
        }
      },
      "required": [
        "organizationId"
      ],
      "type": "object"
    },
    "name": "list_policies"
  },
  {
    "description": "List all meetings in the organization",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "organizationId": {
          "type": "string"
        }
      },
      "required": [
        "organizationId"
      ],
      "type": "object"
    },
    "name": "list_meetings"
  },
  {
    "description": "Get details of a specific meeting",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "meetingId": {
          "type": "string"
        },
        "organizationId": {
          "type": "string"
        }
      },
      "required": [
        "organizationId",
        "meetingId"
      ],
      "type": "object"
    },
    "name": "get_meeting"
  }
]