Helios-9

An AI-native Model Context Protocol (MCP) server that provides comprehensive project management context to AI agents. Built for seamless integration with Claude, OpenAI, and other AI systems via theHelios-9 API.

Stability: Ready for Core Features
Active Tools: 21 (Projects, Initiatives, Tasks, Documents - full hierarchy support)
API Integration: ✅ Fully integrated with Helios-9 SaaS API

- Project Management: Create, read, update projects with full context
- Task Operations: Kanban boards, task creation, status tracking
- Document Management: Markdown documents with frontmatter metadata
- AI Integration: Structured metadata for optimal AI collaboration
- Real-time Context: Live project statistics and activity feeds

- Tools: 21 tools for projects, initiatives, tasks, and documents
- Resources: Dynamic project and document resources
- Prompts: 9 AI-optimized prompt templates for project workflows

- Frontmatter Support: YAML metadata for AI instructions
- Link Analysis: Internal document linking with[[document-name]]syntax
- Basic Search: Keyword search across projects, tasks, and documents
- Semantic Search: Coming soon with Supabase pgvector integration

- Node.js 16+
- Access to Helios-9 main application with API key generation
- MCP-compatible AI client (Claude Desktop, OpenAI, etc.)

Option 1: Run directly with npx (Recommended)

npx -y helios9-mcp-server@latest --api-key YOUR_HELIOS9_API_KEY

cp .env.example .env # Edit .env with your Helios-9 API configuration

# Required - Helios-9 API Configuration HELIOS_API_URL=https://www.helios9.app HELIOS_API_KEY=your_generated_api_key # Optional LOG_LEVEL=info NODE_ENV=development

- Login to your Helios-9 application
- Navigate to Settings > API Keys
- Click "Generate New API Key"
- Copy the generated key(it will only be shown once)
- Set permissionsfor the key (read/write access to projects, tasks, documents)
- Add the key to your MCP server environment

- Projects: Create, read, update, delete projects
- Tasks: Manage tasks within your projects
- Documents: Create and manage project documentation
- Analytics: Access project insights and metrics

- list_projects- List all projects with filtering
- get_project- Get detailed project information
- create_project- Create new project
- update_project- Update existing project

- list_tasks- List tasks with filtering
- get_task- Get specific task details
- create_task- Create new task
- update_task- Update task status/details

- list_documents- List documents with filtering
- get_document- Get specific document
- create_document- Create markdown document (requires project_id)
- update_document- Update document content

Note: All tools require proper API key authentication and respect user-level data isolation.

- Semantic search across all content
- Task dependencies and workflows
- AI conversation tracking
- Advanced analytics and insights
- Document collaboration features

Projects:/projects,/project/{id}/context,/project/{id}/health,/project/{id}/timeline
Initiatives:/initiatives,/initiatives?project_id={id},/initiative/{id},/initiative/{id}/context
Tasks:/tasks,/tasks?project_id={id},/tasks?initiative_id={id},/task/{id}
Documents:/documents,/documents?project_id={id},/document/{id}
Workspace:/workspace/overview,/workspace/analytics
Search:/search?q={query},/search/semantic?q={query}
Conversations:/conversations?project_id={id},/conversation/{id}
Workflows:/workflows,/workflow/{id}

- project_planning- Generate full project plans with initiatives
- initiative_strategy- Strategic planning for initiatives
- task_breakdown- Break features into actionable tasks
- sprint_planning- Plan sprints with current context

- project_health_check- Analyze project health
- document_review- Review and improve documentation
- daily_standup- Generate standup reports
- project_kickoff- Initial project structuring

- helios9_personality- HELIOS-9's sardonic AI insights

Add to yourclaude_desktop_config.json:

{ "mcpServers": { "helios9": { "command": "npx", "args": ["-y", "helios9-mcp-server@latest"], "env": { "HELIOS_API_URL": "https://helios9.app", "HELIOS_API_KEY": "your_generated_api_key" } } } }

{ "mcpServers": { "helios9": { "command": "node", "args": ["/path/to/helios9-MCP-Server/dist/index.js"], "env": { "HELIOS_API_URL": "https://helios9.app", "HELIOS_API_KEY": "your_generated_api_key" } } } }

{ "mcpServers": { "helios9": { "command": "node", "args": ["/path/to/helios9-MCP-Server/dist/index.js"], "env": { "HELIOS_API_URL": "https://www.helios9.app", "HELIOS_API_KEY": "your_generated_api_key" } } } }

from mcp import MCPClient import os # Set environment variables os.environ["HELIOS_API_URL"] = "https://www.helios9.app" os.environ["HELIOS_API_KEY"] = "your_generated_api_key" client = MCPClient() client.connect_stdio("node", ["/path/to/dist/index.js"]) # List projects projects = client.call_tool("list_projects", {}) # Create task task = client.call_tool("create_task", { "project_id": "uuid", "title": "Implement user authentication", "priority": "high" })

interface Project { id: string user_id: string name: string description?: string status: 'active' | 'completed' | 'archived' created_at: string updated_at: string }

interface Task { id: string title: string description?: string status: 'todo' | 'in_progress' | 'done' priority: 'low' | 'medium' | 'high' project_id: string assignee_id?: string due_date?: string created_at: string updated_at: string created_by: string }

interface Document { id: string title: string content: string // Markdown with frontmatter document_type: 'requirement' | 'design' | 'technical' | 'meeting_notes' | 'note' | 'other' project_id: string // Required created_at: string updated_at: string created_by: string }

- API Key Authentication: Generated from your Helios-9 application
- Secure Storage: API keys are securely stored and managed in Helios-9
- User Context: All operations are performed in the context of the API key owner

- User Isolation: API enforces user-level data access controls
- Permission-based: API keys can have granular permissions
- Audit Logging: All API calls are logged for security and debugging

- API-level: Rate limiting is enforced by the Helios-9 API
- Per-key Limits: Different limits can be set per API key
- Configurable: Limits can be adjusted in the Helios-9 admin panel

┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐ │ AI Client │────│ Helios-9 MCP │────│ Helios-9 API │ │ (Claude, etc.) │ │ Server │ │ Application │ └─────────────────┘ └──────────────────┘ └─────────────────┘ │ │ ┌───────▼──────────┐ │ │ Authentication │ │ │ (API Key) │ │ └──────────────────┘ │ │ ┌────────▼────────┐ │ Database │ └─────────────────┘

- Centralized Auth: Authentication handled by main application
- Consistent Data: Single source of truth for all data
- Security: API-level security controls and monitoring
- Scalability: Can serve multiple MCP clients
- Maintainability: Single codebase for data operations

The server provides health information through logging:

- API connection status
- Authentication state
- Tool execution metrics
- Error rates and types

- Tool call frequency
- Response times
- Authentication success/failure
- API endpoint usage patterns

# Check API key validity curl -H "Authorization: Bearer YOUR_API_KEY" https://www.helios9.app/api/auth/validate

# Verify API URL is accessible curl https://www.helios9.app/api/health

- Check API key permissions in Helios-9 admin panel
- Ensure key has access to required resources (projects, tasks, documents)

# Enable debug logging LOG_LEVEL=debug npm start # Look for API-specific errors grep "API Error" logs/*.log

- Fork the repository
- Create feature branch
- Make changes with tests
- Submit pull request

- TypeScript strict mode
- ESLint configuration
- Prettier formatting
- Conventional commits

This project is part of the Helios-9 platform. See the main project LICENSE for details.

- GitHub Issues for bugs and features
- Discussions for questions and ideas
- Discord for real-time chat

# Dry run to see what will be published npm publish --dry-run # Check package size npm pack --dry-run

# For initial publish or updates npm publish # For beta/alpha releases npm publish --tag beta

# Check if package is available npm view helios9-mcp-server # Test installation npx -y helios9-mcp-server@latest --help

# Patch release (1.0.0 -> 1.0.1) npm version patch # Minor release (1.0.0 -> 1.1.0) npm version minor # Major release (1.0.0 -> 2.0.0) npm version major

Built with ❤️ for the AI-native future of project management

- Semantic Search: AI-powered search using OpenAI embeddings and Supabase pgvector
- Task Dependencies: Link related tasks and track workflows
- AI Conversations: Save and analyze AI agent interactions
- Advanced Analytics: Project insights and productivity metrics
- Bulk Operations: Update multiple items at once
- Workflow Automation: Trigger-based task creation and updates

- Multi-agent collaboration support
- Custom tool creation framework
- Integration with popular project management tools
- Real-time collaboration features

Manage time tracking, projects, clients, and tasks using the Harvest API.

Integrates with the Productboard API, offering 49 specialized tools to manage all major Productboard functionalities.

Integrate the Productboard API into agentic workflows for product management.

Interact with the Productive.io API for project management and productivity tasks.

A server for interacting with the TimeChimp API v2 to manage time tracking and projects.

Interact with task, doc, and project data in Dart, an AI-native project management tool

Perform queries and entity operations in your Fibery workspace.

Magica is your all-in-one AI platform, offering 2500+ cutting-edge tools under a single subscription.

Turn your Make scenarios into callable tools for AI assistants.

Remote MCP server for MeisterTask. Create and manage projects, tasks, and notes from your AI assistant. Hosted (streamable-HTTP) — connect at https://mcp.meistertask.com/mcp