holaspirit-mcp-server

Name: holaspirit-mcp-server
Author: syucream

@syucream

リポジトリホームページ

holaspirit-mcp-server について

A MCP server that accesses to Holaspirit

#mcp #holaspirit #modelcontextprotocol

基本情報

カテゴリ

その他

ライセンス

MIT

ランタイム

node

トランスポート

stdio

公開者

syucream

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

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.