Back to MCP Catalog

Holaspirit API Integration MCP Server

Developer ToolsTypeScript
Access and manage Holaspirit organizational data through Claude
Available Tools

holaspirit_get_circles

Retrieves circles from the Holaspirit organization

holaspirit_get_roles

Retrieves roles from the Holaspirit organization

holaspirit_get_members

Retrieves members from the Holaspirit organization

holaspirit_get_policies

Retrieves policies from the Holaspirit organization

holaspirit_get_domains

Retrieves domains from the Holaspirit organization

Holaspirit API Integration provides a seamless connection between Claude and Holaspirit, a platform for organizational management based on Holacracy principles. This MCP server enables users to query and interact with organizational data, roles, circles, and other Holaspirit resources directly through Claude's interface. With this integration, users can retrieve information about their organization's structure, members, roles, and responsibilities without leaving their conversation with Claude. The server handles authentication and API communication, making it easy to access up-to-date organizational information for decision-making and collaboration.

Holaspirit API Integration

This MCP server allows Claude to interact with your Holaspirit organization data, providing access to organizational structure, roles, circles, and more.

Prerequisites

  • Node.js (version specified in .node-version)
  • A Holaspirit account with API access
  • API credentials for your Holaspirit organization

Installation

  1. Install the package from npm:
npm install holaspirit-mcp-server
  1. Create a .env file in your project root with the following variables:
HOLASPIRIT_API_KEY=your_api_key_here
HOLASPIRIT_ORG_ID=your_organization_id
PORT=3000 # Optional, defaults to 3000
  1. Configure your Claude client to use the MCP server by adding the following to your configuration:
"mcpServers": {
  "holaspirit": {
    "command": "npx",
    "args": [
      "holaspirit-mcp-server"
    ]
  }
}

Running the Server

You can start the server directly with:

npx holaspirit-mcp-server

Or add it to your package.json scripts:

"scripts": {
  "start-holaspirit-mcp": "holaspirit-mcp-server"
}

Docker Support

The server can also be run using Docker:

  1. Build the Docker image:
docker build -t holaspirit-mcp-server .
  1. Run the container:
docker run -p 3000:3000 --env-file .env holaspirit-mcp-server

Usage

Once the server is running, Claude can access your Holaspirit data through the available tools. You can ask Claude to:

  • Retrieve information about circles in your organization
  • Get details about specific roles
  • Find members and their roles
  • Search for specific organizational elements
  • Get information about policies and domains

Example queries:

  • "Show me the main circles in our organization"
  • "What roles does Jane Smith have?"
  • "List all members in the Marketing circle"
  • "What are the responsibilities of the Finance Lead role?"

Troubleshooting

If you encounter issues:

  1. Verify your API key and organization ID are correct
  2. Check that your Holaspirit account has the necessary permissions
  3. Ensure the server is running and accessible to Claude
  4. Check the server logs for any error messages

For more detailed information, visit the Holaspirit API documentation.

Related MCPs

Apple Shortcuts
Developer ToolsJavaScript

Control Apple Shortcuts automations from AI assistants

Clojars Dependency Lookup
Developer ToolsJavaScript

Fetch dependency information from Clojars, the Clojure community's artifact repository

Simple Timeserver
Developer ToolsPython

Provides Claude with current time and timezone information

About Model Context Protocol

Model Context Protocol (MCP) allows AI models to access external tools and services, extending their capabilities beyond their training data.

Generate Cursor Documentation

Save time on coding by generating custom documentation and prompts for Cursor IDE.