Holaspirit MCP Server

🚀 holaspirit-mcp-server

A server supporting the MCP (Model Context Protocol) that can connect to the Holaspirit API. This server provides MCP-compatible access to Holaspirit's API, allowing AI assistants to interact with your Holaspirit data through a standard 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 detailed information about a specific circle
• list_roles - List all roles in the organization
• get_role - Get detailed information about 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 detailed information about a specific meeting

🚀 Quick Start

📦 Installation

Install via Smithery

To automatically install holaspirit-mcp-server for Claude Desktop, visit 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 Examples

Start the MCP Server

Run directly:

npx holaspirit-mcp-server

Or start the installed module using Node.js.

Edit the MCP configuration json of the client:

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

🔧 Technical Details

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 code checks (ESLint and Prettier)
• npm run fix - Automatically fix code issues
• npm run examples - Run example scripts

Contribution Guidelines

1. Fork the repository
2. Create a feature branch
3. Run tests and code checks: npm run lint
4. Commit your changes
5. Push to the branch
6. Submit a pull request