askileTaskpile

Connect Taskpile to your AI

Taskpile is a Model Context Protocol (MCP) server. Once connected, your AI assistant can capture, list, schedule, and complete tasks on your behalf - right from the chat window. No more copy-paste, no more context switching.

In plain language: You're in a chat with Claude or ChatGPT. You say "add 'book dentist' to my Taskpile". It's there. Later you say "what's on my plate today?" and your AI reads it back. That's it. No app-switching.

Set up in Claude

Claude.ai web (Pro / Max / Team) and Claude Desktop both support Taskpile as a connector.

Claude.ai web

  1. Open Settings → Connectors in Claude.
  2. Click Add custom connector and enter:
    https://taskpile.app/api/mcp
  3. Claude opens Taskpile's sign-in screen. Approve the connection - you'll see exactly which tools Claude will be able to use.
  4. Back in any Claude chat, the Taskpile tools are available. Try "what's in my Taskpile inbox?" to confirm.

Claude Desktop

  1. Open Settings → Developer.
  2. Click Add MCP server and enter the URL https://taskpile.app/api/mcp.
  3. Approve the OAuth flow when Claude opens a browser window.
  4. Restart Claude Desktop. Taskpile tools appear under the tools icon in chat.

Prefer a static token? Generate a personal access token in your Taskpile Settings → MCP tokens and use the Authorization header method described under For developers.

Set up in ChatGPT

ChatGPT Plus / Pro / Team / Enterprise can add Taskpile via the Connectors panel.

  1. Open ChatGPT settings and find Connectors (sometimes labelled Apps & Connectors).
  2. Choose Add connector → Connect via URL and enter https://taskpile.app/api/mcp.
  3. ChatGPT opens Taskpile's sign-in. Approve the connection.
  4. Open a new chat. The Taskpile connector is now available - ChatGPT will offer it automatically when a prompt looks task-related.

Don't see "Add connector"? The feature rolls out in waves; check ChatGPT's connector directory or write to inbox@taskpile.app if you're stuck.

Set up in Gemini

Google Workspace Gemini extensions are still rolling out third-party support.

Native Taskpile support for Gemini is on our roadmap once Google Workspace's third-party extension flow goes general-availability. In the meantime, use a server-side MCP client - Gemini CLI, a Genkit-based Node app, or any other MCP-aware tool that runs outside the browser - and point it at https://taskpile.app/api/mcp. Browser-only wrappers won't work today because we restrict CORS to known hosted clients.

Want a heads-up the day Gemini lands? Reply to your morning digest and we'll add you to the list.

Set up in Mistral Le Chat

Le Chat supports custom MCP connectors with OAuth 2.1 auto-detection.

  1. Open Le Chat and go to Connectors.
  2. Click + Add Connector and switch to the Custom MCP Connector tab.
  3. Fill in the fields:
    • Connector name: taskpile - must be lowercase with no spaces or special characters. Le Chat silently keeps the Create button disabled if the name is invalid, without showing an error.
    • Server URL: https://taskpile.app/api/mcp
    • Description: optional - e.g. "My tasks".
  4. Click Create. Le Chat detects OAuth 2.1 automatically and opens Taskpile's sign-in. Approve the connection.
  5. Open a new chat. Try "what's in my Taskpile inbox?" to confirm.

Custom MCP connectors are available on Le Chat plans that support them - check Mistral's connector docs if the option isn't visible.

Example prompts

Once connected, your AI knows the Taskpile vocabulary. A few prompts to try:

  • "Add three tasks about my apartment search to my Taskpile"

    Calls create_task three times, parses your prose into separate titles.

  • "What's overdue?"

    Calls list_tasks, filters to overdue, reads it back conversationally.

  • "Move all my house tasks to the Hus project"

    Searches by topic, then bulk-assigns project. Confirms before moving.

  • "I'm done with the dentist booking - and remind me to follow up on Anna's email in a week"

    One sentence, two tool calls. complete_task + delegate_task with follow-up date.

  • "Set up my morning digest to arrive at 6:30 in Copenhagen time, per project"

    Calls configure_morning_digest with hour, timezone, and mode in one shot.

Troubleshooting

Claude / ChatGPT says it can't reach Taskpile after I approved the connection.
Most often a stale session. In the connector settings, remove Taskpile and add it again. If that doesn't help, write to inbox@taskpile.app with the time of day and your account email.
My AI can list tasks but not create them.
Some hosts ask you to grant per-tool consent on first use. Look for a prompt the next time you ask for a write action - accept it and the rest of the session will flow.
I want to revoke the connection.
Either disconnect from inside Claude / ChatGPT's connector settings, or revoke the token from Taskpile Settings → MCP tokens. Both immediately stop access.
Can my AI see other people's tasks?
No. Every request is scoped to the authenticated user via Row-Level Security in the database. Your AI sees only your tasks.

For developers

Taskpile speaks MCP 2024-11-05 over Streamable HTTP at https://taskpile.app/api/mcp. Two auth paths:

  • Personal access tokens (PATs) - generated in Settings → MCP tokens. Static bearer, no expiry. Send as Authorization: Bearer <token>. Right fit for MCP Inspector, Claude Desktop config file, and programmatic clients.
  • OAuth 2.1 + Dynamic Client Registration (RFC 7591). Discovery at /.well-known/oauth-protected-resource and /.well-known/oauth-authorization-server. PKCE-bound, used by hosted clients (claude.ai web, ChatGPT Connectors).

The MCP server is open source - see github.com/twomasc/taskpile for the implementation, including the full list of tools and their JSON schemas.