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 you can use any MCP-aware Gemini wrapper that supports remote OAuth-protected servers — point it at https://taskpile.app/api/mcp.

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

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.