agentConvoGet
Get agent conversation by id
LABSCO SUMMARY
The agent half is the reason to install it; the project half is what gives an agent something to know.
Knowledge is attached one project or one media file at a time, which keeps the wiring explicit — an agent knows what you handed it and nothing more. Because everything is addressed by id, a session usually opens with the workspace and folder listings before anything interesting happens, and the newer agent-chat and webhook tools sit beside older names for the same reads, so expect some duplication when you scan the list.
What it is
Taskade's own server over its API: 62 tools split between project and task work and the agent side — creating agents, giving them knowledge, prompting them and reading their conversations back.
What you get
- Projects created from content, from a custom template or by copying an existing one, completed and restored, and listed per folder, per workspace or for you alone
- Tasks created several at a time, moved within a project, completed and reopened, carrying notes, start and end dates, assignees by handle and per-project field values
- Agents created by hand or generated from a text prompt, updated, deleted and prompted directly from the client
- Agent knowledge assembled from projects and uploaded media, added and removed one source at a time
- Agent conversations listed and read back, so what an agent has been telling people stays reviewable
- Share links switched on and fetched for a project, and public access enabled for an agent with its public preferences updated
- Webhook subscriptions created against a trigger type and removed by hook id, so changes push outward instead of being polled for
Requirements
A Personal Access Token from Taskade's API settings, in TASKADE_API_KEY, and the workspace, folder or project ids you mean to act on — nearly everything is addressed by id, and the workspace and folder listings are where those come from. Plan matters here: some endpoints, workspace listing among them, are gated on free accounts. Running it with --http instead of stdio serves the same tools on port 3000 for remote clients. Note that Taskade also publishes a separate hosted server for editing a deployed app's code; this package is the one that reads and writes workspace content. MIT.
Setup effort
One command plus a key — npx @taskade/mcp-server, then supply credentials
USE CASES
01
Giving an agent your own material to answer from
Create the agent in a folder, attach the projects and uploaded media it should know, then prompt it from the same session to see what that knowledge actually produces.
02
Turning a pile of notes into a project someone can work
Create the project from the content you already have, add the tasks in one call, then put names and dates against them so it is a plan rather than a list.
03
Standing up the same project shape for every new client
Create it from the template, add the tasks that vary, set the dates, and share the link — the repeatable part stops being manual.
04
Auditing what an agent has been telling people
List the agent's conversations, then open the one worth reading in full. Useful after making an agent public, when the people talking to it are no longer in the room.
05
Keeping another system in step with Taskade
Subscribe a URL of yours to a trigger type so changes push outward instead of being polled for, and unsubscribe by hook id when that integration retires.
62 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
agentConvosGet
Get agent conversations
agentGet
Get agent with id
agentKnowledgeMediaCreate
Create a knowledge media
agentKnowledgeMediaRemove
Remove a knowledge media
agentKnowledgeProjectCreate
Create a knowledge project
agentKnowledgeProjectRemove
Remove a knowledge project
agentPublicAccessEnable
Enable public access in the agent
agentPublicGet
Get public agent
agentPublicUpdate
Update public agent
agentUpdate
Update agent
deleteAgent
Delete an agent
folderAgentGenerate
Generate agent based on input text prompts
folderAgentGet
Get agents in a folder.
folderCreateAgent
Create an agent in a team or workspace.
folderProjectsGet
Get all projects in a team, or in the home team of a workspace.
folderProjectTemplatesGet
Get projects templates in a folder.
getConversation
Get agent conversation by ID
listConversations
List agent conversations
mediaDelete
Delete a media
mediaGet
Get media with id
mediasGet
Get medias in a folder
meProjectsGet
Get all projects of mine
projectBlocksGet
Get all blocks for a project
projectComplete
Mark the project as completed
projectCopy
Copy a project to a folder
projectCreate
Create a project in a team
projectFieldsGet
Get all fields for a project
projectFromTemplate
Create a project from a custom template
projectGet
Get project
projectMembersGet
Get members of a project
projectRestore
Restore project
projectShareLinkEnable
Enable share link in the project
projectShareLinkGet
Get share link for the project
projectTasksGet
Get all tasks for a project
promptAgent
Prompt an agent
publicAgentGet
Get public agent by public agent ID
subscribeWebhook
Subscribe to a webhook for a Taskade event
taskAssigneesGet
Get the assignees of a task
taskComplete
Complete a task in a project
taskCreate
Create one or more tasks in a project
taskDelete
Delete a task in a project
taskDeleteAssignees
Remove assignee from a task
taskDeleteDate
Delete date of a task
taskFieldsValueGet
Get all field values for a task
taskFieldValueDelete
Delete the field value of a task
taskFieldValueGet
Get the field value of a task
taskFieldValuePut
Update/create the field value of a task
taskGet
Get task with id
taskGetDate
Get the date of a task
taskMove
Move a task within the project
taskNoteDelete
Delete the note of a task
taskNoteGet
Get the note of a task
taskNotePut
Add/update a note to the task
taskPut
Update task.
taskPutAssignees
Task assignment
taskPutDate
Create or update date for a task
taskUncomplete
Mark a task as incomplete in a project
unsubscribeWebhook
Remove a previously-created webhook subscription
workspaceCreateProject
Create a project in a workspace
workspaceFoldersGet
Get all folders for a workspace
workspacesGet
Get all workspaces for a user
BEFORE YOU INSTALL
What to know first
Tools you get
62 tools when we connected. Some endpoints, such as workspacesGet, are refused on free Taskade accounts. The five Agent Chat and Webhook tools are marked beta.
Requires
- npx on PATH
- TASKADE_API_KEY in your environment
CONTEXT COST
Moderate Standing cost
Rated by the size of the 62 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx @taskade/mcp-serverMCP Clients
Claude Desktop, Cursor, Windsurf, Cline
JSON
{
"mcpServers": {
"taskade": {
"command": "npx",
"args": [
"-y",
"@taskade/mcp-server"
],
"env": {
"TASKADE_API_KEY": "<YOUR_TASKADE_API_KEY>"
}
}
}
}VS Code
VS CODE · JSON
{
"servers": {
"taskade": {
"command": "npx",
"args": [
"-y",
"@taskade/mcp-server"
],
"env": {
"TASKADE_API_KEY": "${input:taskade_api_key}"
}
}
}
}Run as HTTP server
RUN AS HTTP SERVER · TERMINAL
TASKADE_API_KEY=<YOUR_TASKADE_API_KEY> npx @taskade/mcp-server --http
