settings_input_componentIntegrations

Connect Your Entire Workflow

MCP server for AI assistants. Webhooks for GitHub and GitLab. Import from Jira and Trello. Export to Czech invoicing.

MCP Server: AI's Native Language

mcptask.online provides a dedicated Model Context Protocol server - the standard way AI assistants communicate with external tools. No middleware, no scraping, no custom APIs. Native integration.

What is MCP?

Model Context Protocol (MCP) is the standardized protocol AI assistants like Claude use to communicate with external tools and data sources. Instead of parsing HTML or making HTTP calls, AI speaks MCP natively.

check_circleAI understands data structure immediately
check_circleNo custom integration code needed
check_circleReliable, versioned protocol
check_circleSame interface for all MCP clients

Capabilities

Read Operations:

  • visibilityList projects and tasks
  • visibilityGet task details (description, status, history)
  • visibilityView parent/child relationships
  • visibilityAccess comments and attachments
  • visibilityRead effort logs

Write Operations:

  • editUpdate task status
  • editLog work efforts
  • editAdd comments
  • editAttach files
  • editCreate tasks and subtasks
  • editComplete tasks

Query Operations:

  • searchGet next available task (priority-sorted)
  • searchFilter tasks by project, status, type
  • searchSearch task descriptions
  • searchList recent activity

Setup Instructions

For Claude Code:

 {  "mcpServers": {    "mcptask": {      "command": "npx",      "args": ["-y", "@mcptask/mcp-server"],      "env": {        "MCPTASK_API_KEY": "your-api-key",        "MCPTASK_ACCOUNT": "your-account-code"      }    }  }}

For Claude Desktop:

Same configuration in Claude Desktop settings.

For Other MCP Clients:

Standard MCP protocol over stdio. Contact support for specific client instructions.

Available MCP Tools

ToolDescription
get_next_taskGet highest priority available task
get_taskGet specific task by ID
list_tasksList tasks with filters
update_task_statusChange task state
log_effortLog work on a task
add_commentAdd comment to task
complete_taskMark task as done
create_taskCreate new task

Authentication

API Keys:

  • vpn_keyGenerate from mcptask.online dashboard
  • vpn_keyScoped per workspace
  • vpn_keyRevokable anytime
  • vpn_keyRotate regularly for security

Permissions:

  • securityConfigure what each API key can access
  • securityLimit to specific projects
  • securityRead-only vs. read-write
  • securityAction restrictions

Rate Limits

PlanRequests/Hour
Starter1,000 requests/hour
Professional10,000 requests/hour
EnterpriseCustom

Rate limits are per API key. Contact sales for higher limits.

Version Control

GitHub Integration

check_circleFully Integratedschedule2 minutes

Features

codeWebhook-based event processing
codeAutomatic time logging from commits
codePull request linking to tasks
codeAuto-complete tasks on merge
codePrivate repository support (OAuth)

How It Works

  1. 1Add mcptask.online webhook URL to repository settings
  2. 2Select events: Push, Pull Request
  3. 3Save webhook
  4. 4Developers include task refs in commits: Fix bug #Task-47 2h
  5. 5mcptask.online receives webhook, logs time

Commit Message Format

 <message> #Task-<ID> [duration]

Examples:

- Fix login bug #Task-47 2h

- Implement OAuth #Task-48 3h 30m

- Refactor auth #Task-49 (auto-estimates time)

Pull Request Integration

  • mergePR title/body parsed for task references
  • mergePR linked to task in mcptask.online
  • mergeMerge can auto-complete task
  • mergePR status visible in task

Configuration Options

settingsMultiple repositories per project
settingsCustom task reference patterns
settingsAuto-assign tasks to committers
settingsBranch-based status updates

GitLab Integration

check_circleFully Integratedschedule2 minutes

Features

codeSame capabilities as GitHub
codeWorks with GitLab.com (SaaS)
codeWorks with self-hosted GitLab (12.0+)
codeMerge request linking
codePipeline status tracking

Self-Hosted Setup

  1. 1Add webhook URL to GitLab project
  2. 2Configure secret token
  3. 3Whitelist mcptask.online IPs (if firewall)
  4. 4Test webhook delivery

Security

securityWebhook signature verification
securityToken-based authentication
securityNo source code access (metadata only)
securityTLS encryption required

Project Management Import

Jira Import

check_circleImport Tool Availableworkspace_premiumProfessional, Enterprise

What Imports

checkIssue hierarchy (Epic > Story > Task > Subtask)
checkDescriptions and acceptance criteria
checkComments and discussions
checkFile attachments
checkSprint assignments
checkTime logs (worklogs)
checkCustom fields (mapped)
checkIssue links

What Doesn't Import

removeJira workflows (mcptask.online uses simpler states)
removeJira plugins/extensions
removeAdmin settings
removeUser permissions (re-assign in mcptask.online)

Process

  1. 1Generate Jira API token
  2. 2Connect mcptask.online to Jira
  3. 3Select projects to import
  4. 4Review field mapping
  5. 5Start import (background job)
  6. 6Verify imported data
scheduleTypical Time: 15-30 minutes for medium project

Trello Import

check_circleImport Tool Availableworkspace_premiumProfessional, Enterprise

What Imports

checkBoards → Projects
checkLists → Epics or States (configurable)
checkCards → Tasks
checkChecklists → Subtasks
checkAttachments
checkComments
checkLabels → Tags
checkDue dates

Mapping Options

arrow_forward
HierarchicalLists become Epics containing tasks
arrow_forward
FlatLists become task states
arrow_forward
CustomDefine your own mapping

Process

  1. 1Authorize Trello access
  2. 2Select boards to import
  3. 3Choose mapping style
  4. 4Start import
  5. 5Review and adjust
scheduleTypical Time: 10 minutes

EasyRedmine Import

support_agentAvailable on RequestdiamondEnterprise

Contact sales for EasyRedmine migration assistance.

Enterprise Migration Support

Our team will help you migrate from EasyRedmine with minimal downtime.

mailContact Sales

Invoicing & Billing

Fakturoid (Czech Republic)

check_circleFully IntegratedverifiedAll Plans

Features

checkOAuth 2.0 authentication
checkExport approved efforts → Invoices
checkAutomatic VAT calculation
checkClient mapping
checkPayment tracking

Workflow

  1. 1Approve efforts in mcptask.online
  2. 2Click "Export to Fakturoid"
  3. 3Invoice created in Fakturoid
  4. 4Review and send
  5. 5Mark as billed in mcptask.online
scheduleSetup Time: 5 minutes

iDoklad (Czech Republic)

check_circleFully IntegratedverifiedAll Plans

Features

checkOAuth 2.0 authentication
checkInvoice generation
checkVAT compliance
checkMulti-currency support
checkBank synchronization

Workflow

Same as Fakturoid - select efforts, export, invoice.

Stripe (Global)

check_circleFully Integratedworkspace_premiumProfessional, Enterprise

Features

checkSubscription billing
checkOne-time payments
checkInvoice payment links
checkMulti-currency
checkFailed payment handling

Use Cases

arrow_forwardSaaS companies billing clients
arrow_forwardAgencies with retainer clients
arrow_forwardInternational payments

REST API &Webhooks (Outgoing)

REST API

check_circleFully Documentedworkspace_premiumProfessional, Enterprise

Full REST API for custom integrations beyond MCP. Use when you need direct HTTP access or custom workflows.

Authentication

checkJWT tokens (recommended)
checkAPI keys (simpler)
checkOAuth 2.0 (for apps)

Endpoints

Projects
codeGET /api/{account}/projects - List projects
codeGET /api/{account}/projects/{id} - Get project
codePOST /api/{account}/projects - Create project
codePUT /api/{account}/projects/{id} - Update project
Tasks (Pieces)
codeGET /api/{account}/pieces - List tasks
codeGET /api/{account}/pieces/{id} - Get task
codePOST /api/{account}/pieces - Create task
codePUT /api/{account}/pieces/{id} - Update task
Efforts
codeGET /api/{account}/pieces/{id}/efforts - List efforts
codePOST /api/{account}/pieces/{id}/efforts - Log effort
Users
codeGET /api/{account}/users - List users
codeGET /api/user - Current user

Rate Limits

Same as MCP server:

Starter
1,000/hour
Professional
10,000/hour
Enterprise
Custom

Documentation

descriptionInteractive API explorer
descriptionCode examples (Python, JavaScript, Ruby, cURL, PHP)
descriptionPostman collection

Webhooks (Outgoing)

workspace_premiumProfessional, Enterprise

Send events from mcptask.online to your systems.

Available Events

webhooktask.created
webhooktask.updated
webhooktask.completed
webhookeffort.logged
webhooksprint.started
webhooksprint.completed
webhookcomment.added

Use Cases

checkSend Slack notifications
checkTrigger CI/CD pipelines
checkUpdate external dashboards
checkCustom automation

Configuration

  1. 1Add webhook URL in settings
  2. 2Select events to send
  3. 3Configure secret for signature
  4. 4Test delivery

Requested Integrations (Roadmap)

Vote for what you need:

chat

Communication

thumb_up
Slack (250 votes) - Task notifications, slash commands
thumb_up
Microsoft Teams (120 votes) - Similar to Slack
thumb_up
Discord (80 votes) - For dev teams using Discord
calendar_month

Calendar

thumb_up
Google Calendar (200 votes) - Sync deadlines
thumb_up
Outlook (100 votes) - Microsoft ecosystem
design_services

Design

thumb_up
Figma (150 votes) - Link designs to tasks
cloud_upload

Cloud Storage

thumb_up
Google Drive (180 votes) - Attach files from Drive
thumb_up
Dropbox (90 votes) - File integration

Request an integration: Contact support with your use case.

Integration Comparison by Plan

IntegrationStarterProfessionalEnterprise
MCP Servercheck_circlecheck_circle✓ (dedicated)
GitHub Webhookscheck_circlecheck_circlecheck_circle
GitLab Webhookscheck_circlecheck_circlecheck_circle
Fakturoidcheck_circlecheck_circlecheck_circle
iDokladcheck_circlecheck_circlecheck_circle
Stripe-check_circlecheck_circle
Jira Import-check_circlecheck_circle
Trello Import-check_circlecheck_circle
REST API-check_circlecheck_circle
Outgoing Webhooks-check_circlecheck_circle
Custom Integrations--check_circle