holaspirit-mcp-server

What is holaspirit-mcp-server?

holaspirit-mcp-server is an MCP (Model Context Protocol) server that provides standardized access to the Holaspirit API, enabling AI assistants to interact with Holaspirit organizational data through a set of predefined tools.

How to use holaspirit-mcp-server?

Install via npm (npm install holaspirit-mcp-server) or Smithery, then configure by setting the HOLASPIRIT_API_TOKEN and HOLASPIRIT_ORGANIZATION_ID environment variables. Run with stdio transport (default) using npx holaspirit-mcp-server or with HTTP transport using npx holaspirit-mcp-server --port 3000.

Key features of holaspirit-mcp-server

• List tasks, metrics, circles, roles, domains, policies, and meetings in the organization
• Get detailed information for a specific circle, role, or meeting
• Retrieve member feed and search for a member by email
• Get tensions for a meeting or meetings
• Supports both stdio and HTTP (Streamable HTTP) transport modes
• Configuration via environment variables or .env file

Use cases of holaspirit-mcp-server

• An AI assistant queries all open tasks across the organization
• A manager fetches details about a specific circle’s roles and policies
• A team lead retrieves meeting agendas and associated tensions
• An HR tool searches for a member by email and views their feed
• A developer integrates Holaspirit data into custom workflows using HTTP transport

FAQ from holaspirit-mcp-server

What tools does holaspirit-mcp-server provide?

It provides 13 tools: holaspirit_list_tasks, holaspirit_list_metrics, holaspirit_list_circles, holaspirit_get_circle, holaspirit_list_roles, holaspirit_get_role, holaspirit_list_domains, holaspirit_list_policies, holaspirit_list_meetings, holaspirit_get_meeting, holaspirit_get_member_feed, holaspirit_get_tensions, and holaspirit_search_member.

How do I configure holaspirit-mcp-server?

Set the environment variables HOLASPIRIT_API_TOKEN (your API token) and HOLASPIRIT_ORGANIZATION_ID (your organization ID). You can also use a .env file copied from .env.example.

What transport modes are supported?

The server supports two transport modes: stdio (default, for stdin/stdout clients) and HTTP (Streamable HTTP protocol on a configurable port, accepting POST requests on any path).

How do I run holaspirit-mcp-server with a client like Claude Desktop?

Install via Smithery (npx -y @smithery/cli install holaspirit-mcp-server --client claude) or manually configure the MCP client JSON with the command npx -y holaspirit-mcp-server and the required environment variables.