Helios-9

You run an MCP server that provides project context to AI agents. It exposes project, task, and document data in a structured way so AI clients like Claude or OpenAI can manage work, stay in sync with live project activity, and collaborate efficiently.

How to use

Connect to the Helios-9 MCP server from your AI client by configuring a local or remote MCP entry. You typically run the server as a standalone process and point your client at it using either a standard IO (stdio) connection or a remote HTTP URL if available. Once connected, you can list, create, update, and fetch projects, tasks, and documents, and use the included prompts to plan and analyze work.

How to install

Prerequisites: you need Node.js 16 or newer and access to the Helios-9 API with an API key.

Option 1: Run directly with npx (recommended) Typeset for quick start.

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

Option 2: Clone and build locally. Follow these steps to run the server from source.

npm install
cp .env.example .env
# Edit .env with your Helios-9 API configuration
npm run build
npm start

Configuration and startup environment

Set these environment variables for the MCP server to connect to Helios-9. You can place them in a local .env file or export them in your shell before starting the server.

# Required
HELIOS_API_URL=https://www.helios9.app
HELIOS_API_KEY=your_generated_api_key

# Optional
LOG_LEVEL=info
NODE_ENV=development

Example MCP connections for clients

You can connect to the MCP server using a client configuration. The following examples show how to run the MCP server from the client side using a standard IO connection through npx. Use these as templates in your client configuration.

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

Security and access control

All actions are authenticated via your Helios-9 API key. Keys govern read/write access to projects, tasks, and documents and are managed in your Helios-9 account. Data access is isolated per user and logged for auditing and debugging.

Troubleshooting

Common issues can include authentication failures due to an invalid API key, connectivity problems to the Helios-9 API, or permission errors if your key lacks access to needed resources.

# Validate API key (example)
curl -H "Authorization: Bearer YOUR_API_KEY" https://www.helios9.app/api/auth/validate

Notes

Semantic search and deeper analytics are planned for future releases, along with task dependencies, AI conversations, and enhanced document collaboration features.

Available tools

list_projects

List all projects with optional filtering and metadata.

get_project

Fetch detailed information for a specific project.

create_project

Create a new project with given attributes.

update_project

Update properties of an existing project.

list_tasks

List tasks with filtering by project or initiative.

get_task

Retrieve details for a specific task.

create_task

Create a new task within a project.

update_task

Update task attributes or status.

list_documents

List markdown documents with filtering.

get_document

Fetch a specific document by ID.

create_document

Create a markdown document under a project.

update_document

Update content of an existing document.