Workast MCP server
Commit Nov 12, 2026Lets an AI client manage tasks, projects, documents, and meetings within Workast spaces.
Also known as workast/mcp, mcp
- Stars
- 1
- Tools
- 32
- Downloads, 30 days
- —
- Latest version
- 1.4.1
- Last commit
- Nov 12, 2026
- License
- MIT
What is Workast MCP?
Workast lets an AI client manage tasks, projects, documents, and meetings within Workast spaces. It exposes 32 tools, such as workast_search_tasks, workast_retrieve_tasks, workast_create_tasks.
Summary generated from the project's README
About Workast MCP server
Managing team projects, tasks, and meeting follow-ups directly from an AI interface is what Workast enables. Developers and teams can use this server to bridge the gap between their coding environment and their project management workspace. By connecting to clients like Cursor, VS Code, Visual Studio, Claude, or ChatGPT, users can instruct an agent to create tasks, update space READMEs, or summarize meeting transcripts without leaving their current workflow.
The server operates via a remote connection to a specific URL and requires authorization through a sign-in process. For automated agents that cannot interact with a login prompt, headless access is available using a bearer token. The system maintains accuracy by reading existing space READMEs to follow established formatting rules and custom fields. It provides specific tools for handling tasks, managing spaces, finding coworkers, writing notes, creating draft forms, and retrieving meeting details or saved reports.
What you can do with it
- 1Automate task creation from plansConvert a written project plan into organized tasks within a specific workspace.
- 2Sync meeting outcomes to tasksReview meeting transcripts to add comments to existing tasks or generate new ones based on discussions.
- 3Maintain workspace documentationDraft or update the README files for different project spaces to ensure consistent work formatting.
- 4Manage bug report intakeGenerate a draft form for reporting bugs that can be published to collect responses as tasks.
Written from the project's README. Every use case is checked against a quote from it.
How to install Workast MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Workast MCP in Claude Code
$ claude mcp add --transport http mcp https://mcp.workast.com/mcpInstall Workast MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.workast.com/mcp"
}
}
}Install Workast MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.workast.com/mcp"
}
}
}Install Workast MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://mcp.workast.com/mcp"}'Install Workast MCP in Codex
$ codex mcp add mcp --url https://mcp.workast.com/mcpInstall Workast MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] url = "https://mcp.workast.com/mcp"
Install Workast MCP in Gemini CLI
$ gemini mcp add -s user --transport http mcp https://mcp.workast.com/mcpInstall Workast MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.workast.com/mcp",
"type": "http"
}
}
}Workast MCP tools 32
Detected from the READMEworkast_search_tasksworkast_retrieve_tasksworkast_create_tasksworkast_create_personal_tasksworkast_create_subtasksworkast_update_tasksworkast_complete_tasksworkast_create_commentworkast_list_task_activityworkast_list_spacesworkast_retrieve_spaceworkast_create_space
| workast_search_tasks | — | |
| workast_retrieve_tasks | — | |
| workast_create_tasks | — | |
| workast_create_personal_tasks | — | |
| workast_create_subtasks | — | |
| workast_update_tasks | — | |
| workast_complete_tasks | — | |
| workast_create_comment | — | |
| workast_list_task_activity | — | |
| workast_list_spaces | — | |
| workast_retrieve_space | — | |
| workast_create_space | — |
Show all 32 toolsShow fewer tools
workast_update_spaceworkast_update_space_readmeworkast_list_space_participantsworkast_add_space_participantsworkast_about_meworkast_list_coworkersworkast_list_notesworkast_retrieve_noteworkast_create_noteworkast_update_noteworkast_list_formsworkast_create_formworkast_list_meetingsworkast_retrieve_meetingworkast_list_fieldsworkast_create_fieldworkast_update_fieldworkast_list_reportsworkast_retrieve_reportworkast_ping
| workast_update_space | — | |
| workast_update_space_readme | — | |
| workast_list_space_participants | — | |
| workast_add_space_participants | — | |
| workast_about_me | — | |
| workast_list_coworkers | — | |
| workast_list_notes | — | |
| workast_retrieve_note | — | |
| workast_create_note | — | |
| workast_update_note | — | |
| workast_list_forms | — | |
| workast_create_form | — | |
| workast_list_meetings | — | |
| workast_retrieve_meeting | — | |
| workast_list_fields | — | |
| workast_create_field | — | |
| workast_update_field | — | |
| workast_list_reports | — | |
| workast_retrieve_report | — | |
| workast_ping | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableworkast/mcp is public and reachablegithub.com/workast/mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/workast/mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model32 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubWorkast MCP
Organize work with your team and agents.
Ask Cursor, Claude, or ChatGPT for a task, a meeting follow-up, or a report. The work lands in the spaces your team already uses.
Add Workast
Add the server, then authorize when the client asks you to sign in to Workast.
The server is https://mcp.workast.com/mcp.
Cursor
Cursor asks you to add Workast, then asks you to sign in.
To add it yourself, put this in ~/.cursor/mcp.json for every project, or in .cursor/mcp.json for one repo:
{
"mcpServers": {
"workast": {
"url": "https://mcp.workast.com/mcp"
}
}
}
VS Code
VS Code asks you to sign in to Workast.
To add it yourself, put this in .vscode/mcp.json:
{
"servers": {
"workast": {
"type": "http",
"url": "https://mcp.workast.com/mcp"
}
}
}
Visual Studio
Visual Studio asks you to sign in to Workast.
Claude
Open Customize → Connectors → Add → Custom → Web. Enter https://mcp.workast.com/mcp and choose sign in. Claude asks you to authorize.
ChatGPT
Open Plugins, choose Add custom MCP server, and enter https://mcp.workast.com/mcp. Choose OAuth. ChatGPT asks you to authorize.
Claude Code
claude mcp add --transport http workast https://mcp.workast.com/mcp
In Claude Code, run /mcp and sign in to Workast when asked.
Any other client
Add https://mcp.workast.com/mcp. The client asks you to authorize.
Ask for work
After you authorize, paste a prompt.
Turn a plan into tasks
Read the launch plan in the Marketing space. Create the tasks on the Open list, and assign them the way that space's README says.
Pick up a task from a link or a short id
What's going on with TQ7ZK? If it's still open, comment that we're blocked on design.
Close the loop after a meeting
From this week's product meeting, comment on each task we discussed. Create anything we agreed to that is not already a task.
See the work on your plate
What is assigned to me this week? Use the saved report if there is one.
Write a space down
Draft a README for the Bugs space from how we already write those tasks. Show it to me before you save it.
Open a form
Create a draft form in the Support space for bug reports. Give me the link to publish it.
What you can ask for
- Tasks. Create, search, update, complete, comment, and split work into subtasks. Personal tasks too.
- Spaces. Find or create a space, set its lists, invite people, and update the README that says how work there is written.
- People. See who you are, find a teammate, and assign them.
- Notes and forms. Read and write notes. Create a draft form that turns responses into tasks. You publish the form.
- Meetings. List meetings in a date range and read one, including the transcript when you ask for it.
- Fields and reports. Use the custom fields a space already has. Open a saved report and the tasks in it.
How it stays accurate
This server includes a Workast skill. The client reads it and follows the product's rules.
Before it creates work in a space, it reads that space's README and uses the lists, fields, and format written there.
If the repo has a WORKAST.md file, that file names the space for the project.
It looks up spaces, people, and tasks. If a lookup finds nothing, it says so.
Headless access
Use a key when an agent cannot show a sign-in prompt. Log in to your Workast account and create a key for that agent. You stay logged in as yourself. The agent uses the key.
{
"mcpServers": {
"workast": {
"url": "https://mcp.workast.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_KEY"
}
}
}
}
Replace YOUR_KEY with the key you created.
Tools
Tasks
| Tool | What it does |
|---|---|
workast_search_tasks |
Search tasks |
workast_retrieve_tasks |
Get tasks by id or short id |
workast_create_tasks |
Create tasks in a space |
workast_create_personal_tasks |
Create personal tasks |
workast_create_subtasks |
Create subtasks |
workast_update_tasks |
Update tasks |
workast_complete_tasks |
Mark tasks done |
workast_create_comment |
Comment on a task |
workast_list_task_activity |
Read activity on a task |
Spaces
| Tool | What it does |
|---|---|
workast_list_spaces |
Find spaces |
workast_retrieve_space |
Read a space, its lists, and its README |
workast_create_space |
Create a space |
workast_update_space |
Update a space, its lists, and its fields |
workast_update_space_readme |
Replace a space README |
workast_list_space_participants |
See who is in a space |
workast_add_space_participants |
Add people to a space |
People
| Tool | What it does |
|---|---|
workast_about_me |
Current user and team |
workast_list_coworkers |
Find teammates |
Notes
| Tool | What it does |
|---|---|
workast_list_notes |
List notes in a space |
workast_retrieve_note |
Read a note |
workast_create_note |
Create a note |
workast_update_note |
Update a note |
Forms
| Tool | What it does |
|---|---|
workast_list_forms |
List forms |
workast_create_form |
Create a draft form |
Meetings
| Tool | What it does |
|---|---|
workast_list_meetings |
List meetings in a date range |
workast_retrieve_meeting |
Read a meeting |
Fields and reports
| Tool | What it does |
|---|---|
workast_list_fields |
List custom fields |
workast_create_field |
Create a field and turn it on for a space |
workast_update_field |
Update a field |
workast_list_reports |
List saved reports |
workast_retrieve_report |
Open a report and its tasks |
Connection
| Tool | What it does |
|---|---|
workast_ping |
Check that the connection works |
Contributing
See CONTRIBUTING.md. To report a vulnerability, see SECURITY.md.
License
MIT
Workast MCP questions
How do I add Workast MCP to Claude Code?
Run claude mcp add --transport http mcp https://mcp.workast.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Workast MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Workast MCP provide?
It exposes 32 tools, including workast_search_tasks, workast_retrieve_tasks, workast_create_tasks, workast_create_personal_tasks, workast_create_subtasks.
How do I add Workast to Cursor?
You can add it by putting the server configuration in your ~/.cursor/mcp.json or .cursor/mcp.json file.
Can I use Workast with an agent that cannot show a sign-in prompt?
Yes, you can use headless access by creating an API key in your Workast account and providing it in the Authorization header.
What kind of tasks can the AI manage?
The AI can create, search, update, complete, comment on, and split tasks into subtasks, including personal tasks.
How does the server ensure it follows project rules?
The server includes a Workast skill that allows the client to read a space's README to follow specific lists, fields, and formats.