holaspirit-mcp-server

A MCP(Model Context Protocol) server that accesses to Holaspirit API.

Features

Available 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
• holaspirit_search_member

Quick Start# Installation\n\n#### Installing via Smithery

To install holaspirit-mcp-server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install holaspirit-mcp-server --client claude
```\n\n#### Manual Installation
```bash
npm install holaspirit-mcp-server
```\n\n### Configuration
You can configure the server using environment variables.\n\n#### Environment Variables
- `HOLASPIRIT_API_TOKEN`: Your Holaspirit API token
- `HOLASPIRIT_ORGANIZATION_ID`: Your Holaspirit organization ID\n\n#### Using .env File
Create a `.env` file in the project root:
```bash\n\n# Copy the example file
cp .env.example .env

Then edit .env with your actual values:

HOLASPIRIT_API_TOKEN=your_api_token_here
HOLASPIRIT_ORGANIZATION_ID=your_organization_id_here
```\n\n### Usage
The server supports two transport modes:\n\n#### Stdio Transport (Default)
For use with MCP clients that communicate via stdin/stdout:
```bash
npx holaspirit-mcp-server
```\n\n#### HTTP Transport
For use with web clients or HTTP-based integrations using the latest Streamable HTTP protocol:
```bash
npx holaspirit-mcp-server --port 3000
```\n\n### Development# Available Scripts
- `npm run dev`
- `npm run build`
- `npm run start`
- `npm run lint`
- `npm run fix`
- `npm run examples`\n\n### 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