Holaspirit

holaspirit-mcp-server

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:

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

Manual Installation

1npm install holaspirit-mcp-server

Configuration

• HOLASPIRIT_API_TOKEN: Your Holaspirit API token

Usage

Start the MCP server

Directly:

1npx holaspirit-mcp-server

Or, run the installed module with node.

Edit MCP configuration json for your client:

1...
2    "lightdash": {
3      "command": "npx",
4      "args": [
5        "-y",
6        "holaspirit-mcp-server"
7      ],
8      "env": {
9        "HOLASPIRIT_API_TOKEN": "<your token>"
10      }
11    },
12...

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

1. Fork the repository
2. Create your feature branch
3. Run tests and linting: npm run lint
4. Commit your changes
5. Push to the branch
6. Create a Pull Request