Taskpile.app

by twomasc

272 downloads

Not rated

GitHub

About

Never forget a thing. Stay focused on what matters today. Taskpile is a personal task tracker that catches every thought, errand, or "I should…" in seconds — from Claude, ChatGPT, Cursor, Le Chat, Lovable, or any MCP-compatible chat client.

Details

Author: twomasc
Downloads: 272
Categories: AI, Project Management, Productivity

- 57 tools covering task, project, tag, and team operations
- Bulk endpoints accept up to 200 IDs per call
- Streamable HTTP transport (JSON-RPC 2.0) with OAuth 2.1 + PKCE
- Tools for morning digest, inbox email, incremental sync, and review queue
- Verified compatibility with Claude, ChatGPT, Cursor, Zed, and others
- GDPR-compliant; data stored in EU-hosted servers

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Taskpile.app

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "taskpile.app": {
            "taskpile": {
                "type": "http",
                "url": "https://taskpile.app/api/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "taskpile.app": {
            "taskpile": {
                "type": "http",
                "url": "https://taskpile.app/api/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "taskpile.app": {
            "taskpile": {
                "type": "http",
                "url": "https://taskpile.app/api/mcp"
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "taskpile.app": {
            "taskpile": {
                "type": "http",
                "url": "https://taskpile.app/api/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "taskpile.app": {
            "taskpile": {
                "type": "http",
                "url": "https://taskpile.app/api/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "taskpile.app": {
            "taskpile": {
                "type": "http",
                "url": "https://taskpile.app/api/mcp"
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "taskpile.app": {
            "taskpile": {
                "type": "http",
                "url": "https://taskpile.app/api/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "taskpile.app": {
            "taskpile": {
                "type": "http",
                "url": "https://taskpile.app/api/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "taskpile.app": {
            "taskpile": {
                "type": "http",
                "url": "https://taskpile.app/api/mcp"
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "taskpile.app": {
            "taskpile": {
                "type": "http",
                "url": "https://taskpile.app/api/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "taskpile.app": {
            "taskpile": {
                "type": "http",
                "url": "https://taskpile.app/api/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "taskpile.app": {
            "taskpile": {
                "type": "http",
                "url": "https://taskpile.app/api/mcp"
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "taskpile.app": {
            "taskpile": {
                "type": "http",
                "url": "https://taskpile.app/api/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "taskpile.app": {
            "taskpile": {
                "type": "http",
                "url": "https://taskpile.app/api/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "taskpile.app": {
            "taskpile": {
                "type": "http",
                "url": "https://taskpile.app/api/mcp"
            }
        }
    }
}

From the repository

Point any MCP-compatible client (Claude.ai, Claude Desktop, ChatGPT, Cursor, Zed, and others) at https://taskpile.app/api/mcp. Authentication is handled automatically via OAuth 2.1 with Dynamic Client Registration + PKCE; users sign in to Taskpile in a browser tab when prompted.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "taskpile.app": {
            "taskpile": {
                "type": "http",
                "url": "https://taskpile.app/api/mcp"
            }
        }
    }
}

McpServers

{
    "taskpile": {
        "type": "http",
        "url": "https://taskpile.app/api/mcp"
    }
}

Taskpile MCP

Public documentation for Taskpile's Model Context Protocol server. Taskpile is an AI-first task manager designed to be used through your chat client — capture tasks in Claude, plan in ChatGPT, finish in Taskpile. - App: <https://taskpile.app> - MCP endpoint: https://taskpile.app/api/mcp - Transport: Streamable HTTP (JSON-RPC 2.0) - Protocol versions supported: 2025-06-18, 2025-03-26, 2024-11-05 This repository contains only public-facing documentation for the MCP integration. The Taskpile app itself is a hosted commercial product — its source isn't here, but everything you need to connect a client and use the MCP tools is.

Connecting

Any MCP-compatible client can connect by pointing at the URL above. Authentication uses OAuth 2.1 with Dynamic Client Registration + PKCE — the client handles this automatically; users sign in to Taskpile in a browser tab when prompted. Verified clients: | Client | Status | | --- | --- | | Claude.ai (Connectors) | ✅ | | Claude Desktop (via mcp-remote) | ✅ | | Claude Code | ✅ | | ChatGPT (Connectors) | ✅ | | Le Chat (Mistral) | ✅ | | Cursor | ✅ | | Zed | ✅ | | MCP Inspector | ✅ | | Lovable.app | ✅ |

Quick start by client

See examples/ for ready-to-paste config snippets: - Claude Desktop - Cursor - Cline (VS Code) - MCP Inspector For hosted clients like Claude.ai and ChatGPT, add Taskpile via their built-in connector UI and paste the URL above; no local config needed.

Tools

Taskpile exposes 57 tools spanning task CRUD, projects, tags, search, bulk operations, teams, and account integrations like morning digest. The full machine-readable schema (names, descriptions, JSON Schema for inputs) is in tools.json — auto-generated from the live server, so it's always in sync with what tools/list returns. A quick taste: - create_task, list_tasks, update_task, complete_task, delete_task - assign_horizon (today_morning, tomorrow, next_week, etc.), delegate_task, set_recurrence - list_projects, create_project, archive_project - search_tasks (free-text + status/horizon filters) - bulk_complete, bulk_delete, bulk_assign_horizon (up to 200 ids per call) - changes_since (incremental sync), get_today, get_review_queue - get_morning_digest, configure_morning_digest - whoami, get_inbox_email - Teams: create_team, invite_to_team, accept_invitation, assign_task, convert_project_to_shared, etc. - search and fetch (ChatGPT Connectors built-in tools, mapped to Taskpile)

Conventions

A few project-wide conventions worth knowing if you're writing a prompt: - Tags use @tag_name. Projects use #project_name. Do NOT use # for tags — #foo is silently treated as a project name. - create_task parses #project and @tag shorthand from the title. Only the FIRST # token becomes the project; the rest are stripped. - To set tags at creation, pass tags: string[] and/or put @tag in the title. Both forms work and are de-duplicated. - update_task does not parse #/@ shorthand from the title. Use tags / addTags / removeTags and projectId to change those. - Prefer dedicated verbs over update_task when they exist: complete_task, assign_horizon, delegate_task. - Bulk endpoints accept up to 200 ids per call.

Auth flow

If you're building a client and want to know what to expect: 1. Client sends an unauthenticated request to https://taskpile.app/api/mcp and receives 401 with WWW-Authenticate: Bearer realm="taskpile", resource_metadata="https://taskpile.app/.well-known/oauth-protected-resource". 2. Client fetches https://taskpile.app/.well-known/oauth-protected-resource and …/oauth-authorization-server to discover endpoints. 3. Client POSTs to https://taskpile.app/oauth/register for Dynamic Client Registration (RFC 7591). 4. Client kicks off the standard authorization-code + PKCE flow, opens a browser at /oauth/authorize, exchanges the code at /oauth/token, and receives an access_token. 5. Subsequent requests carry Authorization: Bearer <token>. Tokens are valid for 30 days; no refresh-token flow — clients re-run the authorize/token dance on expiry. HEAD /api/mcp returns 200 without auth and is intended for liveness probes only.

Privacy + data handling

- Taskpile is GDPR-compliant. Tasks, projects, and tags created via MCP are user-owned and visible only to the authenticated user (and their team members for shared projects). - The MCP integration sends task content to Taskpile's servers (EU-hosted). It does NOT route through Anthropic, OpenAI, or any other LLM provider — those are clients of the MCP server, not the server itself. - Personal access tokens can be created in Taskpile → Settings → Integrations and revoked at any time.

Issues and feedback

This repo is for documentation. Bug reports about the MCP server, feature requests for new tools, or questions about the API — please open an issue here and we'll triage. For Taskpile app issues (unrelated to MCP), please contact us through the app at <https://taskpile.app>.

License

Documentation in this repository is MIT-licensed (see LICENSE). The Taskpile app itself is a hosted commercial product and is not licensed for redistribution.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Taskpile.app

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

Claude Desktop / Cursor

McpServers

Taskpile MCP

Connecting

Quick start by client

Tools

Conventions

Auth flow

Privacy + data handling

Issues and feedback

License

Install

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Taskpile MCP

Connecting

Quick start by client

Tools

Conventions

Auth flow

Privacy + data handling

Issues and feedback

License

Install

More like this

Time

GitLab

Context 7

1Panel

🔎 GPT Researcher

Serena