Integrations that end with an invoice — not a closed ticket.
The only tool where integrations close the whole cycle: task → commit → merge → work report → invoice. No manual retyping, no middleware.
MCP server for AI assistants · inbound webhooks from GitHub and GitLab · import from Jira and Trello · export to Czech invoicing.
Run your project from chat — no terminal, no new UI
Paste one URL into Claude Cowork or claude.ai and you can plan, log time, and reply to clients straight from the conversation. OAuth 2.0 — no token, no config file.
Remote MCP server URL
https://mcptask.online/mcp/ssePaste this URL into Customize → Connectors → Add custom connector in Cowork / claude.ai
Using Claude Cowork or claude.ai? Connect in 2 minutes with one URL — no terminal, no new dashboard.
- 1
Create an account
30-day free trial, no card.
- 2
Paste the URL
One URL, no token, no Client ID.
- 3
Approve and chat
OAuth in your browser, then chat.
Detailed steps
On a Team or Enterprise plan?
An Owner first adds the connector in Organization settings → Connectors (https://claude.ai/admin-settings/connectors): Add → hover Custom → Web → paste the URL → Add. Each member then connects it themselves in Customize → Connectors — it carries a Custom label.
Heads up on architecture
The connection originates from Anthropic's cloud infrastructure, not from your machine. That is also true for Cowork and Claude Desktop. mcptask.online is publicly reachable, so no firewall or VPN setup is required.
Create your mcptask.online account
Free 30-day trial, no card. You can do this right now in a different tab.
Be logged in
The OAuth approval happens in this browser, so the account you just created has to be the active session here.
Open Customize → Connectors in Cowork / claude.ai
In Cowork or claude.ai, go to https://claude.ai/customize/connectors. Click the + and choose Add custom connector.
Paste the mcptask.online URL
Paste this URL — no Client ID or Secret, no token. Dynamic client registration handles the rest.
Remote MCP server URLhttps://mcptask.online/mcp/sseClick Connect and approve
Click Connect. Your browser opens the mcptask.online OAuth approval page — log in (if you aren't already) and click Authorize. No token, no password is shared with Anthropic.
Enable the connector in your chat
In a new chat, click + (lower left), choose Connectors and toggle mcptask.online on. Try a first prompt:
List my projects and my next task.
From commit to invoice — automatically
Competitors end when the PR closes the ticket. mcptask.online keeps going until the invoice is issued.
Commit with %
A commit message like https://mcptask.online/ACCOUNT/tasks/47 40% updates the piece automatically.
Piece advances
The linked task moves forward and the effort is logged — no one opens the board to drag cards.
PR / MR merged
Merge triggers approval and a completion note. The last effort is set to 100%.
Work report ready
Reported time is collected into a clean work report for the period and client.
Invoice issued
One click creates the invoice in Fakturoid or iDoklad, with VAT and client mapping handled.
Others stop at 'ticket closed'. mcptask.online stops at 'invoice sent'.
Setup takes 5 minutes. No middleware, no scraping, no custom code.
Transition Without Risk
Coexist with the tools you already have. Sync both ways, then leave only when you want to.
Jira Integration
Features
How it works
- 1In mcptask.online, open Project → Settings → Integrations → Jira, and enter your Jira base URL and the target project key (e.g. PROJ).
- 2In your Jira user profile, create an API token and paste it into your mcptask.online user role (or override the username used to connect to Jira).
- 3On any task, pick "Export to Jira" — a Jira issue is created in the configured project and the issue key is prepended to the task name (PROJ-123 My task).
- 4On any Epic, Story, Task, or Recurent, pick "Import from Jira" — mcptask.online fetches the issue summary and creates a matching piece in the current project.
- 5Adding a comment, logging an effort, or finishing a piece pushes the update back to the linked Jira issue.
Configuration
Trello Integration
Features
How it works
- 1Enable Trello in Project → Settings → Integrations and pick the target Trello board.
- 2Paste your Trello member token (API key + token) in Settings → Integrations on your user role.
- 3On any task, choose "Export to Trello" — a new card is created in the configured board and the task name is prefixed with the card's short ID.
- 4To import a card, type its name when creating a new task — the description is filled from the Trello card.
- 5After that, comments, logged efforts, and finishing the task all flow to the linked Trello card as comments automatically.
Configuration
EasyRedmine Integration
Features
How it works
- 1In mcptask.online, open Project → Settings → Integrations → EasyRedmine and enter your EasyRedmine base URL and the target project ID.
- 2In your EasyRedmine user profile, generate an API key and paste it into your user role on the project.
- 3Pick a custom field name on your EasyRedmine project that will carry the difficulty from mcptask.online (e.g. "Difficulty").
- 4On any task, pick "Export to EasyRedmine" — an issue is created and the piece name gets a #ID - prefix so the link goes both ways.
- 5On any Epic, Story, Task, or Recurent, start the name with #ID - when creating it — mcptask.online fetches the issue summary and seeds the piece description.
- 6After that, comments, logged efforts, and finishing the piece flow to the linked issue as notes automatically.
Configuration
Invoicing & Billing
Fakturoid (Czech Republic)
Features
Workflow
- 1Reports → Work report
- 2Select company, period from the 1st to the end of the month
- 3Click "Issue invoice to Fakturoid"
- 4Invoice is created in Fakturoid
iDoklad (Czech Republic)
Features
Workflow
- 1Reports → Work report
- 2Select company, period from the 1st to the end of the month
- 3Click "Issue invoice on iDoklad"
- 4Invoice is created in iDoklad
Stripe (mcptask.online's Own Billing)
Heads-up: Stripe here powers mcptask.online's own subscription billing (per-seat Starter/Professional/Enterprise). It is NOT a way to bill your clients through mcptask.online. For client billing, use Fakturoid or iDoklad above.
What Stripe does here
This is for…
A PM Tool the Agent Drives
mcptask.online is built MCP-first. The agent doesn't just read your tasks — it uses the workspace as its work queue: get_next_task → work → log_work_progress → add_message.
What an autonomous workflow looks like
Plug in an MCP client and the workspace becomes the agent's to-do list, progress log, and hand-off channel.
You queue it at night, it's merged by morning — on your machine, with any model
mcptask_runner is an autonomous developer that runs on your own infrastructure and uses this MCP server as its work queue. No lock-in to a single model or a cloud sandbox.
What is MCP?
MCP (Model Context Protocol) is the standard protocol AI assistants like Claude use to call external tools and read external data. Instead of parsing HTML or hand-rolling HTTP, the AI speaks MCP natively and we serve the tool definitions.
What you can do over MCP
Read:
- List projects and pieces (tasks/stories/epics)
- Get piece details (description, status, history)
- View parent/child relationships
- Access comments and attachments
- View work performed
Write:
- Update piece status
- Log work efforts
- Add comments
- Attach files
- Create pieces and subtasks
Query:
- Get next available piece (priority-sorted)
- Filter pieces by project, status, type
- Search piece descriptions
- List recent activity
For Developers
No middleware, no scraping, no fictional endpoints. Set up in 5 minutes and drive mcptask.online from your AI client, Git host, or server script.
- Claude Cowork / claude.ai — detailed OAuth walkthrough
Full click-by-click walkthrough. If you only need the headline, the main section above has it.
Create your mcptask.online account
Free 30-day trial, no card. You can do this right now in a different tab.
Be logged in
The OAuth approval happens in this browser, so the account you just created has to be the active session here.
Open Customize → Connectors in Cowork / claude.ai
In Cowork or claude.ai, go to https://claude.ai/customize/connectors. Click the + and choose Add custom connector.
Paste the mcptask.online URL
Paste this URL — no Client ID or Secret, no token. Dynamic client registration handles the rest.
Remote MCP server URLhttps://mcptask.online/mcp/sseClick Connect and approve
Click Connect. Your browser opens the mcptask.online OAuth approval page — log in (if you aren't already) and click Authorize. No token, no password is shared with Anthropic.
Enable the connector in your chat
In a new chat, click + (lower left), choose Connectors and toggle mcptask.online on. Try a first prompt:
List my projects and my next task.
On a Team or Enterprise plan?
An Owner first adds the connector in Organization settings → Connectors (https://claude.ai/admin-settings/connectors): Add → hover Custom → Web → paste the URL → Add. Each member then connects it themselves in Customize → Connectors — it carries a Custom label.
Heads up on architecture
The connection originates from Anthropic's cloud infrastructure, not from your machine. That is also true for Cowork and Claude Desktop. mcptask.online is publicly reachable, so no firewall or VPN setup is required.
- Connect from Claude Code / Cursor / Cline — .mcp.json
Use this if you prefer to drive mcptask.online from a terminal-based AI client. After this, every MCP client you connect (Claude Code, Cursor, Cline, …) can talk to mcptask.online.
1. Get your MCPTASK_TOKEN
Log in to mcptask.online → View user → Advanced info → API Token. Copy the long string.
2. Export it in your shell
Paste this in your terminal (or add to ~/.zshrc / ~/.bashrc so it persists):
export MCPTASK_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxx3. Drop this in your client's .mcp.json
.mcp.json{ "mcpServers": { "mcptask-online": { "type": "sse", "url": "https://mcptask.online/mcp/sse", "headers": { "Authorization": "Bearer ${MCPTASK_TOKEN}" } } }}4. Where does the file live?
Claude Code reads .mcp.json from your project root (or ~/.claude.json globally). For Claude Desktop / Cursor / Cline, paste the same JSON into the client's MCP config dialog.
5. Restart your AI client
Claude Code, Cursor, etc. pick up MCP servers on restart. You'll see the mcptask-online server listed in available tools.
Other MCP clients
Standard MCP over SSE. Use the same URL (https://mcptask.online/mcp/sse) and the same Authorization: Bearer header as above.
- GitHub webhooks — push + pull request
GitHub Integration
Live (Inbound Webhooks)5 minutesFeatures
Two repository webhooks — one for push events, one for pull request eventsCommit messages link work to a piece and set its progress percentagePull request body references link the PR and approve the piece on mergeSigned with your account secret token via X-Hub-Signature-256How it works
- 1Copy your account secret token from mcptask.online (Account → Integrations).
- 2In your GitHub repository, add a webhook with Payload URL https://mcptask.online/github/efforts, select Just the push event, and paste the secret token.
- 3Add a second webhook with Payload URL https://mcptask.online/github/pulls, select Let me select individual events → Pull requests, and paste the same secret token.
- 4In commit messages, add a line https://mcptask.online/ACCOUNT/tasks/ID NN% where NN is the progress percentage.
- 5In pull request descriptions, add a line mcptask: https://mcptask.online/ACCOUNT/tasks/ID.
- 6When the PR is merged, the referenced piece is approved and the last effort is set to 100%.
How to reference a piece
Use the piece's public URL https://mcptask.online/ACCOUNT/tasks/ID. ACCOUNT is your account code and ID is the piece's relative ID shown on the piece page and in the URL.
Examples:
https://mcptask.online/ACCOUNT/tasks/47 40%https://mcptask.online/ACCOUNT/tasks/48 100%mcptask: https://mcptask.online/ACCOUNT/tasks/47Pull Request Integration
- PR opened → a note with the PR link is added to the piece
- PR merged → the piece is approved and a completion note is added
- The last effort's progress is set to 100% on merge
- Works with any public or private repository that can reach mcptask.online
Configuration
Two webhooks per repository (separate endpoints for push and pull request events)Private repository supportNo source code access — only webhook metadata is processedTLS required - GitLab webhooks — push + merge request
GitLab Integration
Live (Inbound Webhooks)5 minutesFeatures
Two project webhooks — one for push events, one for merge request eventsCommit messages link work to a piece and set its progress percentageMerge request description references link the MR and approve the piece on mergeAuthenticated by the X-Gitlab-Token header (your account's secret token)How it works
- 1Copy your account secret token from mcptask.online (Account → Integrations).
- 2In your GitLab project, add a webhook with URL https://mcptask.online/gitlab/efforts, trigger Push events, and paste the secret token into the Secret token field.
- 3Add a second webhook with URL https://mcptask.online/gitlab/merge_requests, trigger Merge request events, and use the same secret token.
- 4In commit messages, add a line https://mcptask.online/ACCOUNT/tasks/ID NN% where NN is the progress percentage.
- 5In merge request descriptions, add a line mcptask: https://mcptask.online/ACCOUNT/tasks/ID.
- 6When the MR is merged, the referenced piece is approved and the last effort is set to 100%.
How to reference a piece
Use the piece's public URL https://mcptask.online/ACCOUNT/tasks/ID. ACCOUNT is your account code and ID is the piece's relative ID shown on the piece page and in the URL.
Examples:
https://mcptask.online/ACCOUNT/tasks/47 40%https://mcptask.online/ACCOUNT/tasks/48 100%mcptask: https://mcptask.online/ACCOUNT/tasks/47Merge Request Integration
- MR opened → a note with the MR link is added to the piece
- MR merged → the piece is approved and a completion note is added
- The last effort's progress is set to 100% on merge
- Works with GitLab.com and self-hosted GitLab (12.0+) that can reach mcptask.online
Configuration
Two webhooks per project (separate endpoints for push and merge request events)Self-hosted GitLab support (12.0+)No source code access — only webhook metadata is processedTLS required - REST API — JSON over HTTP
REST API
Live (Stable)Professional, EnterpriseJSON over HTTP, scoped to your account. Use it when MCP isn't a fit (server-to-server scripts, dashboards, non-MCP tools).
Authentication
One credential, one header. The same MCPTASK_TOKEN you use for the MCP server authenticates every REST API call as a Bearer token.
HeaderAuthorization: Bearer <MCPTASK_TOKEN>Get a token in mcptask.online → View user → Advanced info → API Token. JWT-encoded, signed with HS256, scoped to your user — no separate API key, no per-account rotation.
Endpoints
All endpoints are scoped to your account code (the short code from your mcptask.online URL). Real paths use /pieces (the generic term) rather than /tasks — we use "piece" as the umbrella word for task, story, epic, recurent.
Projects
GET /api/{account_code}/projects - List projectsPieces (Tasks, Stories, Epics, Recurents)
GET /api/{account_code}/pieces/{id} - Get piecePOST /api/{account_code}/pieces - Create pieceEfforts
GET /api/{account_code}/pieces/{id}/efforts - List effortsPOST /api/{account_code}/pieces/{id}/efforts - Log effortUsers
GET /api/{account_code}/users/{id} - Get userGET /api/{account_code}/users/current - Current userRate Limits
Same limits as the MCP server — enforced per account and per token:
Starter1,000/hourProfessional10,000/hourEnterpriseCustomDocumentation
Real calls you can paste in a terminal right now. Replace $MCPTASK_TOKEN with a token from View user → Advanced info → API Token and $ACCOUNT with your account code.
Check API version (no token needed)curl https://mcptask.online/apiResponse{ "message": "mcptask.online REST API v0.10", "version": "0.10", "version_app": "5.72", "revision": "1272" }Identify the current usercurl https://mcptask.online/api/$ACCOUNT/users/current \ -H "Authorization: Bearer $MCPTASK_TOKEN"Response{ "id": 7, "user_nick": "george", "email": "george@example.com", "default_account_code": "bcp" }List your projectscurl https://mcptask.online/api/$ACCOUNT/projects \ -H "Authorization: Bearer $MCPTASK_TOKEN"Response[ { "id": 1, "code": "bcp", "name": "BCP Development" } ]Create a piece (Task)curl -X POST https://mcptask.online/api/$ACCOUNT/pieces \ -H "Authorization: Bearer $MCPTASK_TOKEN" \ -H "Content-Type: application/json" \ -d ''{"piece_type":"Task","name":"Review PR","project_id":1}''Response{ "id": 42, "name": "Review PR", "piece_type": "Task", "state": "new" } - Quick glossary
Quick glossary
A few terms used across this page, in plain English.
MCPModel Context Protocol — a standard way AI assistants (Claude, Cursor, Cline, …) talk to external tools. mcptask.online speaks MCP natively, so any MCP client can drive it.
SSEServer-Sent Events — the HTTP transport MCP uses for streaming tool calls. Your AI client opens a long-lived connection to our /mcp/sse URL.
WebhookAn HTTP call one app makes to another when something happens. Inbound = something calls mcptask.online (e.g. GitHub on push). Outbound = mcptask.online calls your system (planned, not live yet).
MCPTASK_TOKENA long random string that proves to mcptask.online that a request really comes from you. Generate it once in mcptask.online → View user → Advanced info → API Token and use it as a Bearer token. Treat it like a password.
Custom connectorThe claude.ai / Cowork UI for adding a remote MCP server by URL. You give it the URL, click Connect, and the OAuth flow finishes the wiring — no token to copy, no config file to edit.
- Available MCP tools
Available MCP Tools
The 14 tools below are the real ones shipped by mcptask.online's MCP server today. AddMessageTool, AddAttachmentTool, CreatePieceTool, LogWorkProgressTool and the read-side tools work end-to-end.
Tool Description create_pieceCreate a new piece (task, story, epic, recurent) get_pieceFetch a single piece by ID list_piecesList pieces with filters (project, status, type) get_next_taskGet the highest-priority available task get_project_treeGet the project hierarchy (epics/stories/tasks) list_projectsList projects you have access to get_projectFetch one project's metadata get_current_userIdentify the user behind the current token log_work_progressLog effort on a piece and update its progress add_messageAdd a comment / message to a piece add_attachmentAttach a file to a piece get_attachmentFetch attachment metadata and a direct download URL for a piece get_piece_effortsRead time-tracking entries for a piece get_usage_guideSelf-describe the server (capabilities and usage hints) - Authentication
Authentication
Two ways in, depending on your client. Claude Code / Cursor / Cline use a long-lived MCPTASK_TOKEN (Bearer). Claude Cowork / claude.ai use OAuth 2.0 with dynamic client registration — you never touch a token.
MCPTASK_TOKEN (Bearer — for Claude Code, Cursor, Cline):
- View user → API token in mcptask.online
- Tied to your user account, scoped to your workspaces
- Once and forever — no annoying periodic rotations
- Treat it like a password — anyone holding it acts as you
OAuth 2.0 (for Claude Cowork / claude.ai):
- No client secret, no manual credential — dynamic client registration
- PKCE S256 — secure even on public clients
- Approval is per-workspace — you pick which mcptask.online workspace the connector can act on
- Revoke from claude.ai at any time (Customize → Connectors → Remove)
Permissions:
- Token inherits your user permissions — no extra scopes today
- Read-only vs. read-write is controlled by the actions you call
- Per-project isolation is enforced server-side
- All calls are logged under your user
- Rate limits
Rate Limits
Plan Requests/Hour Starter 1,000 requests/hour Professional 10,000 requests/hour Enterprise Custom Limits are enforced per account and per token: 60 requests/minute per token, plus the hourly per-account cap shown below. Contact us if you need a higher ceiling.
Planned Integrations (Roadmap)
Things we are considering. If one matters to you, mail us — high-demand items get prioritized.
Outgoing Webhooks
Missing an integration?
Request it
Request an integration: email us with your use case. We pick the next batch of integrations from real demand, not votes.
Connect Your Workflow Today
Need custom integration or migration assistance?
Request Custom Integration