What is Holaspirit Mcp Server

holaspirit-mcp-server is an MCP server that provides access to the Holaspirit API, enabling AI assistants to interact with Holaspirit data through a standardized interface.

Use cases

Use cases include automating task management, generating reports on organizational metrics, and facilitating communication within teams by accessing Holaspirit data through AI assistants.

How to use

To use holaspirit-mcp-server, install it via Smithery or manually using npm. Configure your Holaspirit API token and start the server using the command ‘npx holaspirit-mcp-server’.

Key features

Key features include listing tasks, metrics, circles, roles, domains, policies, and meetings within the organization, as well as retrieving details for specific circles, roles, and meetings.

Where to use

holaspirit-mcp-server can be used in organizational management, project management, and team collaboration environments where Holaspirit is utilized.

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