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

npm install holaspirit-mcp-server

Configuration

Create a .env file with your Holaspirit API credentials:

HOLASPIRIT_API_TOKEN=your_api_token

Usage

Start the MCP server:

npx holaspirit-mcp-server

For example usage, check the examples directory. To run the example:

# Set required environment variables
export EXAMPLES_CLIENT_HOLASPIRIT_API_TOKEN=your_api_token
export EXAMPLES_CLIENT_HOLASPIRIT_ORGANIZATION_ID=your_organization_id

# Run the example
npm run examples

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