holaspirit-mcp-server

Name: holaspirit-mcp-server
Author: syucream

@syucream

Repository Homepage

About holaspirit-mcp-server

A MCP server that accesses to Holaspirit

#mcp #holaspirit #modelcontextprotocol

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "holaspirit-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "holaspirit-mcp-server",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.