What is Holaspirit

holaspirit-mcp-server is a server that provides access to the Holaspirit API using the Model Context Protocol (MCP). It allows AI assistants to interact with Holaspirit data through a standardized interface.

Use cases

This server can be utilized for automating task management, retrieving organizational metrics, and facilitating communication within circles and roles in an organization, enhancing productivity and collaboration in Holaspirit environments.

How to use

Installation can be done via Smithery CLI for ease of use or manually using NPM. The server can be configured for either standard input/output transport or HTTP transport, with necessary configuration for API tokens and organization ID.

Key features

Key features include functionalities to list tasks, metrics, circles, roles, domains, policies, meetings, and get specific details about circles, roles, meetings, as well as member feeds and tensions.

Where to use

This server is suitable for use in environments where Holaspirit is integrated, such as within teams utilizing AI assistants for enhanced task management, communication, and organizational oversight.

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:

• holaspirit_list_tasks - List all tasks in the organization
• holaspirit_list_metrics - List all metrics in the organization
• holaspirit_list_circles - List all circles in the organization
• holaspirit_get_circle - Get details of a specific circle
• holaspirit_list_roles - List all roles in the organization
• holaspirit_get_role - Get details of a specific role
• holaspirit_list_domains - List all domains in the organization
• holaspirit_list_policies - List all policies in the organization
• holaspirit_list_meetings - List all meetings in the organization
• holaspirit_get_meeting - Get details of a specific meeting
• holaspirit_get_member_feed - Get member feed
• holaspirit_get_tensions - Get tensions for a meeting or meetings
• holaspirit_search_member - Search for a member by email

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
• HOLASPIRIT_ORGANIZATION_ID: Your Holaspirit organization ID

Usage

The server supports two transport modes:

Stdio Transport (Default)

For use with MCP clients that communicate via stdin/stdout:

npx holaspirit-mcp-server

HTTP Transport

For use with web clients or HTTP-based integrations using the latest Streamable HTTP protocol:

npx holaspirit-mcp-server --port 3000

The HTTP server accepts POST requests only on any path (e.g., /, /mcp, /sse) and uses the Streamable HTTP transport protocol.

Edit MCP configuration json for your client:

For stdio transport:

For HTTP transport, configure your client to connect to:

• http://localhost:3000/ (or any path)

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