Skip to content
Back to search

taskade

SkillGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 15 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/taskade/mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/taskade/mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/taskade--mcp/badge.svg)](/listings/taskade--mcp)

HTML

<a href="/listings/taskade--mcp"><img src="/api/listings/taskade--mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 18 lines
  1. {
  2. "name": "taskade",
  3. "owner": { "name": "Taskade", "email": "hello@taskade.com" },
  4. "metadata": { "description": "Taskade for Claude Code and Cowork" },
  5. "plugins": [
  6. {
  7. "name": "taskade",
  8. "source": "./",
  9. "description": "Use Taskade from Claude: projects, tasks, AI agents, automations and Taskade Genesis apps. Needs a paid Taskade plan.",
  10. "version": "0.2.3",
  11. "author": { "name": "Taskade", "url": "https://www.taskade.com" },
  12. "license": "MIT",
  13. "homepage": "https://www.taskade.com/mcp",
  14. "category": "productivity",
  15. "keywords": ["taskade", "genesis", "mcp"]
  16. }
  17. ]
  18. }
README.md · README · 755 lines
  1. <div align="center">
  2. # Taskade MCP Server and Agent Plugin
  3. Paste this to your agent:
  4. ```text
  5. Set up Taskade for me: https://www.taskade.com/SKILL.md
  6. ```
  7. **[Taskade](https://www.taskade.com) is the AI-native workspace for projects, AI agents and automations. [Taskade Genesis](https://www.taskade.com/create) builds a running app from one prompt.**
  8. **Connect Taskade to Claude, Claude Code, ChatGPT, Codex, Cursor, VS Code, GitHub Copilot, Gemini CLI, Windsurf and any other client of the [Model Context Protocol](https://modelcontextprotocol.io/).**
  9. [![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=taskade&config=eyJ1cmwiOiJodHRwczovL3d3dy50YXNrYWRlLmNvbS9tY3AifQ%3D%3D)
  10. [![Install in VS Code](https://img.shields.io/badge/Install_in-VS_Code-007ACC?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=taskade&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fwww.taskade.com%2Fmcp%22%7D)
  11. [![Connect in Claude](https://img.shields.io/badge/Connect_in-Claude-D97757?style=flat-square)](https://claude.ai/directory/taskade-ai)
  12. **Claude Code:** `claude mcp add --transport http taskade https://www.taskade.com/mcp`
  13. [![npm](https://img.shields.io/npm/v/@taskade/mcp-server?style=flat-square&color=FF2D60)](https://www.npmjs.com/package/@taskade/mcp-server)
  14. [![GitHub stars](https://img.shields.io/github/stars/taskade/mcp?style=flat-square)](https://github.com/taskade/mcp)
  15. [![License](https://img.shields.io/github/license/taskade/mcp?style=flat-square)](https://github.com/taskade/mcp/blob/main/LICENSE)
  16. **Hosted server:** `https://www.taskade.com/mcp` (Streamable HTTP, OAuth). Nothing to install.
  17. </div>
  18. This repo holds the Taskade [agent plugin](#agent-plugin-for-claude-code-codex-copilot-gemini-cli-and-cursor) and two packages:
  19. - [MCP Server](https://github.com/taskade/mcp/tree/main/packages/server) (`@taskade/mcp-server`): the local stdio server, for clients that cannot connect to a remote server.
  20. - [OpenAPI Codegen](https://github.com/taskade/mcp/tree/main/packages/openapi-codegen): generate MCP tools from any OpenAPI spec, not only Taskade.
  21. ---
  22. ## Agent plugin for Claude Code, Codex, Copilot, Gemini CLI and Cursor
  23. The `taskade` plugin connects your AI tool to your Taskade workspace through the hosted server, and adds skills: a front door (`taskade`) and the job skills (`getting-started`, `import-spreadsheet`, `fix-my-app`, `app-report`, `backup-my-app`, `plan-new-app`). The skills tell the agent which tools to call, in which order, and what to check before it reports back.
  24. - **Plan:** MCP access is part of every paid Taskade plan (Starter and up). Sign in once with your Taskade account.
  25. - **What it does:** imports a spreadsheet into a project, fixes a Taskade Genesis app one checked change at a time, reports on your projects and automations, backs up an app to a folder, and plans a new app.
  26. - **What stays in Taskade:** the plugin cannot build an app, add fields to a project, or create or edit an automation. For those jobs, it writes the request for Taskade EVE. For a new app, it gives you a link that fills in the request and starts nothing. You publish an app and connect a domain in Taskade. For who can use an app, Taskade EVE proposes the setting and you apply it.
  27. | Host | Install |
  28. |---|---|
  29. | Claude Code | `claude plugin marketplace add taskade/mcp`, then `claude plugin install taskade@taskade`. Run `/mcp`, select **taskade** and sign in. |
  30. | Codex | `codex plugin marketplace add taskade/mcp`, then `codex plugin add taskade@taskade` |
  31. | GitHub Copilot CLI | `copilot plugin install taskade/mcp` |
  32. | Gemini CLI | `gemini extensions install https://github.com/taskade/mcp` |
  33. | VS Code | See below |
  34. | Cursor | See below |
  35. | Any other agent | `npx skills add taskade/mcp` installs the skills only. Then add the hosted server `https://www.taskade.com/mcp` to the agent and sign in (see the [quick start](#taskade-mcp-server-quick-start)). |
  36. **VS Code:** turn on the `chat.plugins.enabled` setting. Then run **Chat: Install Plugin From Source** from the Command Palette and enter `https://github.com/taskade/mcp`.
  37. **Cursor:** the Cursor plugin `taskade` (`.cursor-plugin/`) in this repository adds the same hosted server and skills.
  38. **Claude directory:** the directory listing reads the plugin from `plugins/taskade/`, a copy of the root plugin files. The other hosts read the root files.
  39. To add only the hosted server to Codex, run `codex mcp add taskade --url https://www.taskade.com/mcp`, then `codex mcp login taskade`.
  40. ---
  41. ## Contents
  42. - [Agent plugin](#agent-plugin-for-claude-code-codex-copilot-gemini-cli-and-cursor)
  43. - [Taskade MCP server: quick start](#taskade-mcp-server-quick-start) (Claude, Claude Code, ChatGPT, Cursor, VS Code, Windsurf)
  44. - [Hosted tools](#hosted-tools)
  45. - [Example prompts](#example-prompts)
  46. - [Troubleshooting](#troubleshooting)
  47. - [Local package (stdio)](#local-package-stdio)
  48. - [Local package tools (66)](#local-package-tools-66)
  49. - [Why Taskade MCP?](#why-taskade-mcp)
  50. - [Agent Recipes](#agent-recipes)
  51. - [OpenAPI Codegen](#openapi-codegen)
  52. - [What is Taskade?](#what-is-taskade)
  53. - [Privacy & Security](#privacy--security)
  54. - [Support](#support)
  55. - [Contributing](#contributing)
  56. - [License](#license)
  57. ---
  58. ## Demo
  59. MCP-powered Taskade agent running inside Claude Desktop by Anthropic:
  60. ![Taskade MCP Demo: AI agent managing tasks and projects in Claude Desktop](https://github.com/user-attachments/assets/0cee987b-b0d4-4d10-bb7f-da49a080d731)
  61. | Build Agents via MCP | Run Automations | Manage Projects |
  62. |:---:|:---:|:---:|
  63. | <img src="https://raw.githubusercontent.com/taskade/taskade/main/media/agents/agent-generator.gif" width="280" alt="Create AI agents from your IDE via Taskade MCP"> | <img src="https://raw.githubusercontent.com/taskade/taskade/main/media/automations/automation-flows.gif" width="280" alt="Run Taskade automations via Taskade MCP"> | <img src="https://raw.githubusercontent.com/taskade/taskade/main/media/genesis/create-app.gif" width="280" alt="Manage projects and apps via Taskade MCP"> |
  64. | Create, train, deploy AI agents from Claude/Cursor | List automations, run one, and read its runs | Full workspace management from your AI assistant *(paid plans)* |
  65. ---
  66. ## Taskade MCP server: quick start
  67. | | |
  68. |---|---|
  69. | **URL** | `https://www.taskade.com/mcp` |
  70. | **Transport** | Streamable HTTP |
  71. | **Auth** | OAuth 2.0 with PKCE and dynamic client registration. Your client opens a Taskade sign-in page once. |
  72. | **Plan** | MCP access is part of every paid Taskade plan (Starter and up). On the Free plan, `list_spaces` returns no workspaces. |
  73. | **Discovery** | `https://www.taskade.com/.well-known/oauth-protected-resource/mcp` |
  74. An `initialize` request without a token returns `401` on purpose. The `401` tells your client where to start the OAuth sign-in.
  75. ### Claude (web, Desktop and mobile)
  76. Select **Connect in Claude** at the top of this page to open **Taskade AI** in the [Claude directory](https://claude.ai/directory/taskade-ai). To add the server as a custom connector instead:
  77. 1. In Claude, go to [**Customize > Connectors**](https://claude.ai/customize/connectors) and select **Add custom connector**. On a Team or Enterprise plan, an Owner first adds the connector in **Organization settings > Connectors** (**Add**, then **Custom**).
  78. 2. Enter the name `Taskade` and the URL `https://www.taskade.com/mcp`, then select **Add**.
  79. 3. Select **Connect**, sign in to Taskade, and approve access.
  80. 4. In a chat, select **+ > Connectors** and turn on Taskade.
  81. If the dialog asks for an **OAuth client**, select **Register automatically**. The connector also works in Claude Desktop and the Claude mobile apps on the same account.
  82. ### Claude Code
  83. ```bash
  84. claude mcp add --transport http taskade https://www.taskade.com/mcp
  85. ```
  86. Then run `/mcp` in Claude Code and select **taskade** to sign in.
  87. ### ChatGPT
  88. ChatGPT connects to a remote MCP server as a custom connector in developer mode. It uses OAuth only.
  89. 1. In ChatGPT settings, turn on developer mode for apps and connectors.
  90. 2. Create a connector. Enter `Taskade` as the name and `https://www.taskade.com/mcp` as the server URL.
  91. 3. Select OAuth as the authentication. Sign in to Taskade and allow access.
  92. Developer mode is available only on some ChatGPT plans, and its labels change often.
  93. ### Cursor
  94. Select **Add to Cursor** at the top of this page, or add this to `~/.cursor/mcp.json`:
  95. ```json
  96. {
  97. "mcpServers": {
  98. "taskade": {
  99. "url": "https://www.taskade.com/mcp"
  100. }
  101. }
  102. }
  103. ```
  104. ### VS Code
  105. Select **Install in VS Code** at the top of this page, or run:
  106. ```bash
  107. code --add-mcp '{"name":"taskade","type":"http","url":"https://www.taskade.com/mcp"}'
  108. ```
  109. ### Windsurf
  110. Add this to `~/.codeium/windsurf/mcp_config.json`:
  111. ```json
  112. {
  113. "mcpServers": {
  114. "taskade": {
  115. "serverUrl": "https://www.taskade.com/mcp"
  116. }
  117. }
  118. }
  119. ```
  120. ### Other clients and servers (API token)
  121. A client that cannot do OAuth can send a Taskade personal access token as a Bearer token. Create the token in [Taskade Settings > API](https://www.taskade.com/settings/api).
  122. ```json
  123. {
  124. "mcpServers": {
  125. "taskade": {
  126. "type": "http",
  127. "url": "https://www.taskade.com/mcp",
  128. "headers": { "Authorization": "Bearer YOUR_TASKADE_API_TOKEN" }
  129. }
  130. }
  131. }
  132. ```
  133. Full guide: [Hosted Taskade MCP](https://github.com/taskade/docs/blob/main/apis-living-system-development/genesis-app-mcp.md).
  134. ---
  135. ## Hosted tools
  136. Every hosted tool declares MCP tool annotations. Claude can run a read-only tool without a confirmation, and it asks before a tool that deletes or replaces data.
  137. | Area | Read-only tools | Write tools |
  138. |---|---|---|
  139. | Workspaces | `list_spaces`, `list_folders`, `list_media`, `list_templates`, `inspect_space` | `write_file` (Taskade Genesis app source in `app/`) |
  140. | Automations | `list_automations`, `get_flow_runs` | `run_flow` |
  141. | Projects | `list_projects`, `list_my_projects`, `get_project`, `read_project`, `list_fields`, `list_blocks`, `list_project_members`, `get_share_link` | `create_project`, `create_project_from_template`, `copy_project`, `complete_project`, `restore_project`, `enable_share_link` |
  142. | Tasks | `list_tasks` | `create_task`, `update_task`, `complete_task`, `uncomplete_task`, `delete_task`, `move_task`, `set_task_note`, `delete_task_note`, `set_task_date`, `delete_task_date`, `assign_task`, `unassign_task`, `set_task_field_value`, `delete_task_field_value` |
  143. | AI agents | `list_agents`, `get_agent`, `list_conversations`, `get_conversation` | `create_agent`, `update_agent`, `delete_agent`, `prompt_agent`, `add_knowledge_project`, `remove_knowledge_project`, `add_knowledge_media`, `remove_knowledge_media` |
  144. | App kits | `list_my_kits` | `publish_kit_version` |
  145. - `get_flow_runs`: reads the recent runs of one automation, newest first. Each run has its status and times. A failed run also names the failed step and a short error. It needs edit rights on automations.
  146. - `run_flow`: starts one run of an automation that is On and starts "When asked". Every run is real: it counts toward the monthly automation runs of the plan, and AI steps use credits.
  147. The server also serves the resource `taskade://getting-started`, a short guide for the model.
  148. ---
  149. ## Example prompts
  150. 1. **Weekly review.** "List my Taskade workspaces, read the Q4 Roadmap project, and give me the open tasks grouped by assignee."
  151. Tools: `list_spaces`, `list_projects`, `read_project`.
  152. 2. **Plan a launch.** "Create a project called Website Launch in my Marketing workspace with tasks for copy, design, QA and launch day, and set the launch task to November 3."
  153. Tools: `list_spaces`, `create_project`, `create_task`, `set_task_date`.
  154. 3. **Build a support agent.** "Create an agent called Help Bot in my Support workspace, add the FAQ project as its knowledge, then ask it how a customer resets a password."
  155. Tools: `create_agent`, `add_knowledge_project`, `prompt_agent`.
  156. 4. **Close out a sprint.** "In the Sprint 42 project, mark every task that mentions 'shipped' as complete, then mark the project as completed."
  157. Tools: `list_tasks`, `complete_task`, `complete_project`.
  158. 5. **Edit a Taskade Genesis app.** "In my CRM app, read `app/src/App.tsx` and change the page title to Acme CRM."
  159. Tools: `inspect_space`, `write_file`.
  160. ---
  161. ## Troubleshooting
  162. | Symptom | Cause and fix |
  163. |---|---|
  164. | `401 Unauthorized` on the first request | Expected. Your client must start the OAuth sign-in. If it does not, update the client or use an API token (see above). |
  165. | `list_spaces` returns no workspaces | MCP access needs a paid plan on that workspace. Upgrade at [taskade.com/pricing](https://www.taskade.com/pricing). |
  166. | A tool returns "permission denied" | Your role in that workspace or project does not allow the action. Ask a workspace owner for access. |
  167. | Claude shows "Authorization with the MCP server failed" | Remove the connector, add it again, and sign in to the correct Taskade account. |
  168. | A local `npx` server fails with "TASKADE_API_KEY appears to be invalid" | Create a new token in [Settings > API](https://www.taskade.com/settings/api). |
  169. If the problem continues, open an [issue](https://github.com/taskade/mcp/issues) or email [support@taskade.com](mailto:support@taskade.com).
  170. ---
  171. ## Local package (stdio)
  172. Use the local package when your client supports only stdio servers, or when you need a tool that only the local package has, for example the webhook tools (`subscribeWebhook`, `unsubscribeWebhook`). It runs on your machine with `npx` and calls the Taskade public API over the network with a personal access token.
  173. | I want to... | Use | Where / auth |
  174. |---|---|---|
  175. | Use Taskade from Claude, Cursor, VS Code or another client that supports remote servers | **Hosted server** | `https://www.taskade.com/mcp` · OAuth 2.0 or API token · paid plans |
  176. | Run Taskade tools in a client that supports only stdio, or use the webhook tools | **Local package** (`@taskade/mcp-server`) | `npx` · personal access token · needs network access to taskade.com |
  177. | Let my Taskade agents reach Slack, Shopify or Gmail | **[MCP Connectors](https://github.com/taskade/docs/blob/main/genesis-living-system-builder/genesis/mcp-connectors.md)** | Hosted, in the Taskade app |
  178. ### 1. Get Your API Key
  179. Go to [Taskade Settings > API](https://www.taskade.com/settings/api) and create a Personal Access Token.
  180. ### 2. Claude Desktop
  181. Add to your `claude_desktop_config.json`:
  182. ```json
  183. {
  184. "mcpServers": {
  185. "taskade": {
  186. "command": "npx",
  187. "args": ["-y", "@taskade/mcp-server"],
  188. "env": {
  189. "TASKADE_API_KEY": "your-api-key-here"
  190. }
  191. }
  192. }
  193. }
  194. ```
  195. ### 3. Cursor
  196. Add to your Cursor MCP settings:
  197. ```json
  198. {
  199. "mcpServers": {
  200. "taskade": {
  201. "command": "npx",
  202. "args": ["-y", "@taskade/mcp-server"],
  203. "env": {
  204. "TASKADE_API_KEY": "your-api-key-here"
  205. }
  206. }
  207. }
  208. }
  209. ```
  210. ### 4. Windsurf
  211. Add to `~/.codeium/windsurf/mcp_config.json` (or **Settings → Cascade → MCP → Add Server**):
  212. ```json
  213. {
  214. "mcpServers": {
  215. "taskade": {
  216. "command": "npx",
  217. "args": ["-y", "@taskade/mcp-server"],
  218. "env": {
  219. "TASKADE_API_KEY": "your-api-key-here"
  220. }
  221. }
  222. }
  223. }
  224. ```
  225. ### 5. Cline
  226. In VS Code, open the Cline **MCP Servers** panel → **Configure MCP Servers** and add:
  227. ```json
  228. {
  229. "mcpServers": {
  230. "taskade": {
  231. "command": "npx",
  232. "args": ["-y", "@taskade/mcp-server"],
  233. "env": {
  234. "TASKADE_API_KEY": "your-api-key-here"
  235. }
  236. }
  237. }
  238. }
  239. ```
  240. ### 6. VS Code
  241. Add a `.vscode/mcp.json` to your workspace (VS Code uses the `servers` key; `${input:…}` prompts for your key on first run):
  242. ```json
  243. {
  244. "servers": {
  245. "taskade": {
  246. "command": "npx",
  247. "args": ["-y", "@taskade/mcp-server"],
  248. "env": {
  249. "TASKADE_API_KEY": "${input:taskade_api_key}"
  250. }
  251. }
  252. }
  253. }
  254. ```
  255. ### 7. Remote and HTTP clients
  256. The local package runs over stdio only. It has no HTTP or SSE mode. For a client that connects over HTTP, use the hosted server at `https://www.taskade.com/mcp` (see [Taskade MCP server: quick start](#taskade-mcp-server-quick-start)).
  257. ---
  258. ## Local package tools (66)
  259. The local package has its own tool names. They map to the Taskade public API v1 and v2.
  260. ### Workspaces
  261. | Tool | Description |
  262. |------|-------------|
  263. | `workspacesGet` | List all workspaces |
  264. | `workspaceFoldersGet` | List folders in a workspace |
  265. | `workspaceCreateProject` | Create a project in a workspace |
  266. ### Projects
  267. | Tool | Description |
  268. |------|-------------|
  269. | `projectGet` | Get project details |
  270. | `projectCreate` | Create a new project |
  271. | `projectCopy` | Copy a project to a folder |
  272. | `projectComplete` | Mark project as completed |
  273. | `projectRestore` | Restore a completed project |
  274. | `projectMembersGet` | List project members |
  275. | `projectFieldsGet` | Get custom fields for a project |
  276. | `projectShareLinkGet` | Get the share link |
  277. | `projectShareLinkEnable` | Enable the share link |
  278. | `projectBlocksGet` | Get all blocks in a project |
  279. | `projectTasksGet` | Get all tasks in a project |
  280. | `listTasks` | List tasks in a project, with a filter for open or completed tasks (API v2) |
  281. | `renameProject` | Rename a project (API v2) |
  282. | `folderProjectsGet` | List projects in a folder |
  283. ### Tasks
  284. | Tool | Description |
  285. |------|-------------|
  286. | `taskGet` | Get task details |
  287. | `taskCreate` | Create one or more tasks |
  288. | `createTask` | Create 1 to 20 tasks (API v2) |
  289. | `taskPut` | Update a task |
  290. | `taskDelete` | Delete a task |
  291. | `taskComplete` | Mark task as complete |
  292. | `taskUncomplete` | Mark task as incomplete |
  293. | `taskMove` | Move a task within a project |
  294. | `taskAssigneesGet` | Get task assignees |
  295. | `taskPutAssignees` | Assign users to a task |
  296. | `taskDeleteAssignees` | Remove assignees |
  297. | `taskGetDate` | Get task due date |
  298. | `taskPutDate` | Set task due date |
  299. | `taskDeleteDate` | Remove task due date |
  300. | `taskNoteGet` | Get task note |
  301. | `taskNotePut` | Update task note |
  302. | `taskNoteDelete` | Delete task note |
  303. | `taskFieldsValueGet` | Get all field values |
  304. | `taskFieldValueGet` | Get a specific field value |
  305. | `taskFieldValuePut` | Set a text, number or Select field value |
  306. | `setTaskFieldValue` | Set a text, number, Select or date field value (API v2) |
  307. | `taskFieldValueDelete` | Delete a field value |
  308. ### AI Agents
  309. Create, manage, and publish autonomous AI agents with custom knowledge and tools.
  310. | Tool | Description |
  311. |------|-------------|
  312. | `folderAgentGenerate` | Generate an AI agent from a text prompt |
  313. | `folderCreateAgent` | Create an agent with custom configuration |
  314. | `folderAgentGet` | List agents in a folder |
  315. | `agentGet` | Get agent details |
  316. | `agentUpdate` | Update agent configuration |
  317. | `deleteAgent` | Delete an agent |
  318. | `agentPublicAccessEnable` | Publish agent publicly |
  319. | `agentPublicGet` | Get public agent details |
  320. | `agentPublicUpdate` | Update public agent settings |
  321. | `agentKnowledgeProjectCreate` | Add a project as agent knowledge |
  322. | `agentKnowledgeMediaCreate` | Add media as agent knowledge |
  323. | `agentKnowledgeProjectRemove` | Remove project from knowledge |
  324. | `agentKnowledgeMediaRemove` | Remove media from knowledge |
  325. | `agentConvosGet` | List agent conversations |
  326. | `agentConvoGet` | Get conversation details |
  327. | `publicAgentGet` | Get agent by public ID |
  328. ### Templates
  329. | Tool | Description |
  330. |------|-------------|
  331. | `folderProjectTemplatesGet` | List available project templates |
  332. | `projectFromTemplate` | Create a project from a template |
  333. ### Media
  334. | Tool | Description |
  335. |------|-------------|
  336. | `mediasGet` | List media files in a folder |
  337. | `mediaGet` | Get media details |
  338. | `mediaDelete` | Delete a media file |
  339. ### Personal
  340. | Tool | Description |
  341. |------|-------------|
  342. | `meProjectsGet` | List all your projects |
  343. ### Agent Chat & Webhooks (API v2, beta)
  344. Capabilities the v1 API doesn't have: hold a live conversation with an AI agent, and receive real-time events.
  345. | Tool | Description |
  346. |------|-------------|
  347. | `promptAgent` | Send a message to an AI agent and get its reply |
  348. | `listConversations` | List an agent's conversations |
  349. | `getConversation` | Get a conversation's messages |
  350. | `subscribeWebhook` | Subscribe to real-time Taskade event webhooks |
  351. | `unsubscribeWebhook` | Remove a webhook subscription |
  352. ---
  353. ## Why Taskade MCP?
  354. Taskade MCP gives your AI assistant **access to your workspace** — projects, tasks, agents, knowledge bases, templates, and automations (on paid plans; some endpoints such as workspace listing are gated for free accounts). Instead of writing API code, describe what you need in natural language.
  355. ```
  356. ┌──────────────────────────────────────────────────────────┐
  357. │ HOW TASKADE MCP WORKS │
  358. └──────────────────────────────────────────────────────────┘
  359. You (in Claude/Cursor/Windsurf):
  360. "Create a support agent trained on our docs project"
  361. ↓
  362. ┌──────────────────────────────────┐
  363. │ Taskade MCP Server │
  364. │ (66 tools, 8 categories) │
  365. └──────────────────────────────────┘
  366. ↓ ↓ ↓
  367. folderCreateAgent agentKnowledge agentPublicAccess
  368. (creates agent) (attaches docs) (publishes it)
  369. ↓
  370. Result: Live AI chatbot trained on your data
  371. ```
  372. | What You Say | What Happens |
  373. |-------------|-------------|
  374. | "Show me all overdue tasks" | Reads projects → filters tasks → formats report |
  375. | "Create a support agent trained on our docs" | Creates agent → attaches knowledge → publishes |
  376. | "Set up next week's sprint from our template" | Copies template → populates tasks → assigns team |
  377. | "Summarize the completed work in my Sprint project" | Reads completed tasks → generates a standup summary |
  378. ### Why MCP Instead of REST API?
  379. | | REST API | MCP Server |
  380. |-|----------|-----------|
  381. | **Setup** | Write HTTP client, handle auth, parse JSON | `npx @taskade/mcp-server` — one command |
  382. | **Interface** | Code against endpoints | Natural language — describe what you need |
  383. | **Chaining** | Manual orchestration | AI chains tools intelligently |
  384. | **Error handling** | Write error handling code | AI interprets errors and retries |
  385. ### Why Taskade MCP Over Other MCP Servers?
  386. Taskade MCP includes **AI agent management** (create, train, deploy agents), **knowledge base training** (attach docs, projects, media), and **OpenAPI codegen** (generate MCP tools from any API spec). 66 tools across 8 categories.
  387. ---
  388. ## Agent Recipes
  389. <details>
  390. <summary><b>Recipe 1: Daily Standup Summarizer</b></summary>
  391. <br>
  392. **Problem:** Team standup notes scattered across Slack, email, and docs.
  393. ```
  394. You: "Check my Taskade workspace for yesterday's completed tasks,
  395. summarize them as a standup update, then create today's
  396. priority tasks based on what's still open."
  397. Claude uses:
  398. 1. meProjectsGet → find your active projects
  399. 2. projectTasksGet → pull tasks from each project
  400. 3. taskCreate → create today's priority tasks
  401. Result: A formatted standup summary + fresh task list in Taskade.
  402. ```
  403. </details>
  404. <details>
  405. <summary><b>Recipe 2: Knowledge Base Agent Builder</b></summary>
  406. <br>
  407. **Problem:** You have docs scattered across files and need an AI agent trained on them.
  408. ```
  409. You: "Create an AI support agent called 'Help Bot' in my
  410. Customer Success folder, train it on our Documentation
  411. project, and publish it publicly."
  412. Claude uses:
  413. 1. workspaceFoldersGet → find "Customer Success" folder
  414. 2. folderCreateAgent → create "Help Bot" with support instructions
  415. 3. agentKnowledgeProjectCreate → attach Documentation project
  416. 4. agentPublicAccessEnable → publish with shareable link
  417. Result: Live AI chatbot trained on your docs, ready to embed.
  418. ```
  419. </details>
  420. <details>
  421. <summary><b>Recipe 3: Sprint Planning Automation</b></summary>
  422. <br>
  423. **Problem:** Creating sprint projects manually every two weeks.
  424. ```
  425. You: "Create a new sprint project from our 'Sprint Template',
  426. name it 'Sprint 2026-W15', move the top 10 backlog
  427. items into it, and assign them to the engineering team."
  428. Claude uses:
  429. 1. folderProjectTemplatesGet → find "Sprint Template"
  430. 2. projectFromTemplate → create "Sprint 2026-W15"
  431. 3. projectTasksGet → get backlog items
  432. 4. taskMove → move top 10 tasks to new sprint
  433. 5. taskPutAssignees → assign engineering team members
  434. Result: Sprint ready to go, fully populated and assigned.
  435. ```
  436. </details>
  437. <details>
  438. <summary><b>Recipe 4: Competitive Intelligence Agent</b></summary>
  439. <br>
  440. **Problem:** You need an agent that monitors competitors and reports findings.
  441. ```
  442. You: "Generate an AI agent that researches our top 5 competitors.
  443. Train it on our Competitive Analysis project.
  444. Name it 'Market Intel Agent'."
  445. Claude uses:
  446. 1. folderAgentGenerate → generate agent from research prompt
  447. 2. agentKnowledgeProjectCreate → connect Competitive Analysis project
  448. 3. agentUpdate → refine instructions for research cadence
  449. Result: AI research agent with domain knowledge, ready for briefings.
  450. ```
  451. </details>
  452. <details>
  453. <summary><b>Recipe 5: Client Onboarding Pipeline</b></summary>
  454. <br>
  455. **Problem:** Each new client needs the same project structure, tasks, and materials.
  456. ```
  457. You: "For our new client Acme Corp: create a project from
  458. the 'Client Onboarding' template, add tasks for
  459. kickoff meeting and SOW review, set due dates for
  460. the next 2 weeks, then share the project link."
  461. Claude uses:
  462. 1. projectFromTemplate → create "Acme Corp Onboarding"
  463. 2. taskCreate → add kickoff, requirements, SOW tasks
  464. 3. taskPutDate → set dates across next 2 weeks
  465. 4. projectShareLinkEnable → generate share link
  466. Result: Client onboarding project live and shareable in 30 seconds.
  467. ```
  468. </details>
  469. ---
  470. ## Use Cases
  471. ### Project Management with AI
  472. Ask your AI assistant to manage your Taskade workspace:
  473. - "Show me all my projects and their status"
  474. - "Create a new project called Q1 Planning with tasks for each team"
  475. - "Move all overdue tasks to the Backlog project"
  476. - "Set due dates for all tasks in the Sprint project"
  477. ### AI Agent Creation
  478. Build and deploy AI agents directly from your editor:
  479. - "Create an AI agent called Customer Support Bot with knowledge from our docs project"
  480. - "Generate an agent for code review using this prompt: ..."
  481. - "Publish my agent publicly and give me the share link"
  482. - "Add our API documentation project as knowledge to the agent"
  483. ### Template Workflows
  484. Automate project creation from templates:
  485. - "List all templates in my workspace"
  486. - "Create 5 new client onboarding projects from the Client Template"
  487. - "Copy the Sprint Retrospective project for this week"
  488. ---
  489. ## OpenAPI Codegen
  490. Use our generator to build MCP tools from any OpenAPI spec — not just Taskade.
  491. ```bash
  492. npm install --save-dev @taskade/mcp-openapi-codegen @readme/openapi-parser
  493. ```
  494. ```ts
  495. import { dereference } from '@readme/openapi-parser';
  496. import { codegen } from '@taskade/mcp-openapi-codegen';
  497. const document = await dereference('your-api-spec.yaml');
  498. await codegen({
  499. path: 'src/tools.generated.ts',
  500. document,
  501. });
  502. ```
  503. Works with any OpenAPI 3.0+ spec. Generate MCP tools for your own APIs in minutes.
  504. ---
  505. ## What is Taskade?
  506. [Taskade](https://www.taskade.com) ([Y Combinator S19](https://www.ycombinator.com/companies/taskade)) is the AI-native workspace for building apps, deploying agents, and automating workflows from a single prompt. **150,000+ apps built.**
  507. - **Genesis Apps** — Build complete apps from prompts. Dashboards, CRMs, portals, forms — deployed instantly. [Try it →](https://www.taskade.com/create)
  508. - **AI Agents** — Custom agents with built-in tools, persistent memory, multi-agent teams, public embedding
  509. - **Automations** — No-code workflow automation with 100+ integrations, branching, looping, filtering
  510. - **Real-time Collaboration** — Multiplayer workspace with chat, video, and multiple project views
  511. - **Templates**: templates for project management, engineering, marketing, and more
  512. - **API & MCP**: REST API v2, this MCP server, the agent plugin, Agent API, webhooks, OAuth 2.0
  513. **Links:**
  514. - App: [taskade.com](https://www.taskade.com)
  515. - Create: [taskade.com/create](https://www.taskade.com/create)
  516. - Apps gallery: [taskade.com/apps](https://www.taskade.com/apps) · [all categories](https://www.taskade.com/apps/categories)
  517. - Agents: [taskade.com/agents](https://www.taskade.com/agents)
  518. - Templates: [taskade.com/templates](https://www.taskade.com/templates)
  519. - Docs: [taskade.com/docs](https://www.taskade.com/docs) · [docs.taskade.com](https://docs.taskade.com)
  520. - **Workspace MCP guide:** https://github.com/taskade/docs/blob/main/apis-living-system-development/workspace-mcp.md
  521. - **Hosted MCP guide:** https://github.com/taskade/docs/blob/main/apis-living-system-development/genesis-app-mcp.md
  522. - Blog: [taskade.com/blog](https://www.taskade.com/blog)
  523. ---
  524. ## Roadmap
  525. See [open issues](https://github.com/taskade/mcp/issues) for planned features and improvements.
  526. **Recently shipped (v0.1.0):** Agent chat (`promptAgent`) and webhook triggers, live now via the [Taskade API v2 tool layer](#agent-chat--webhooks-api-v2-beta).
  527. - **Automation tools**: the hosted server lists automations, reads their runs and runs an automation that is On and starts "When asked" (`list_automations`, `get_flow_runs`, `run_flow`). Create, enable and manage automations through MCP are on the roadmap.
  528. - **`agent.js`** — Open-source autonomous agent toolkit (coming soon)
  529. - **TaskOS** — Agent platform at [docs.taskade.com](https://docs.taskade.com)
  530. ---
  531. ## Privacy & Security
  532. - **Hosted server.** Taskade runs it on `www.taskade.com`. It reads and writes only the workspaces that your Taskade account can access and that are on a paid plan. The server does not read your chat history with the AI client. `prompt_agent` runs a Taskade agent, which can use its own tools, for example web search.
  533. - **Agent plugin.** The plugin holds skills (text files) and the address of the hosted server. It runs no code of its own. The backup skill writes workspace files to a local folder (`./taskade-backup/` unless you name another one).
  534. - **Local package.** Your API token authorizes the server to call the Taskade public API (`https://www.taskade.com/api/v1` and `https://www.taskade.com/api/v2`) on your behalf. The package sends your data to no other service. Keep the token in an environment variable, and never commit it.
  535. - **Privacy policy:** [taskade.com/privacy](https://www.taskade.com/privacy). **Terms:** [taskade.com/terms](https://www.taskade.com/terms).
  536. - **Security and vulnerability reports:** see [SECURITY.md](./SECURITY.md).
  537. ---
  538. ## Support
  539. - Help center: [help.taskade.com](https://help.taskade.com)
  540. - Email: [support@taskade.com](mailto:support@taskade.com)
  541. - Bugs and feature requests: [GitHub issues](https://github.com/taskade/mcp/issues)
  542. ---
  543. ## Contributing
  544. Help us improve MCP tools, OpenAPI workflows, and agent capabilities.
  545. - [Issues](https://github.com/taskade/mcp/issues) — Report bugs or request features
  546. - [Pull Requests](https://github.com/taskade/mcp/pulls) — Contributions welcome
  547. - [Apps](https://www.taskade.com/apps) — Browse and clone community apps · [categories](https://www.taskade.com/apps/categories)
  548. ---
  549. ## More from Taskade
  550. - [Agent skill (`SKILL.md`)](https://www.taskade.com/SKILL.md) · [llms.txt index](https://www.taskade.com/llms.txt) · [Developer docs](https://github.com/taskade/docs)
  551. - [Awesome Vibe Coding](https://github.com/taskade/awesome-vibe-coding) — curated vibe-coding tools, MCP servers, and agent skills
  552. - [Taskade Docs](https://docs.taskade.com) ([source](https://github.com/taskade/docs)) — developer documentation and API reference
  553. - [Integration Kit](https://github.com/taskade/integrations) — open-source Zapier/n8n actions & triggers
  554. - [Taskade on GitHub](https://github.com/taskade) — org home and open-source repos
  555. - [Taskade](https://github.com/taskade/taskade) — platform home, including Genesis, the AI app builder
  556. ---
  557. ## License
  558. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.