Holaspirit

Provides MCP access to Holaspirit data: tasks, circles, roles, meetings, domains, policies and more.

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcp-mirror-syucream_holaspirit-mcp-server": {
      "command": "npx",
      "args": [
        "holaspirit-mcp-server"
      ],
      "env": {
        "HOLASPIRIT_API_TOKEN": "your_api_token"
      }
    }
  }
}

You set up a MCP server that provides a standardized interface to Holaspirit data, enabling AI assistants to query circles, roles, meetings, tasks, and more from Holaspirit through a consistent MCP protocol.

How to use

Start the MCP server from the command line and connect your MCP client to the server. You can issue requests to list and fetch data such as tasks, circles, roles, meetings, and policies. Use the client to call the exposed endpoints in a way that abstracts away the underlying Holaspirit API details, enabling you to operate across your organization’s data with simple, repeatable commands.

How to install

Prerequisites you need before installing:
- Node.js installed on your machine (recommended LTS version)
- npm (comes with Node.js)
- Internet access to fetch packages from npm registry

# Install the MCP server package
npm install holaspirit-mcp-server

Configuration

Create a configuration file to provide your Holaspirit API credentials. The server expects an API token to authorize requests.

HOLASPIRIT_API_TOKEN=your_api_token

Usage and examples

Run the MCP server so your MCP client can connect. The server is started using the CLI, which loads the configuration and begins listening for requests.

npx holaspirit-mcp-server

More practical setup tips

If you want to run examples that demonstrate common workflows, prepare your environment variables as shown and execute the example script provided in the examples section of your installation. This helps you verify connectivity and the availability of each data endpoint.

Available tools

list_tasks

List all tasks in the organization. Returns an overview of tasks and their status for quick planning.

list_metrics

List all metrics in the organization. Retrieve performance or progress metrics tracked in Holaspirit.

list_circles

List all circles in the organization. Explore the organizational structure and circle memberships.

get_circle

Get details of a specific circle by its identifier, including members and roles.

list_roles

List all roles in the organization. View role definitions and associated responsibilities.

get_role

Get details of a specific role, including responsibilities and relationships.

list_domains

List all domains in the organization. Domains categorize areas of work within Holaspirit.

list_policies

List all policies in the organization. Retrieve governance and operational policies.

list_meetings

List all meetings in the organization. See meeting details and schedules.

get_meeting

Get details of a specific meeting, including attendees and agenda.