get_projectsLABSCO SUMMARY
Sprint status without opening the board.
The sprint summary and the task-detail tools are what save time — one call gets the sprint's status distribution instead of counting cards. Semantic search is the one capability with an extra dependency behind it: it queries a vector database you stand up separately, so treat it as opt-in.
What it is
A server over the Goodday project-management API, grouped into project, task, sprint, user and search tools.
What you get
- Projects: get_projects with archived and root-only filters, get_project, create_project and get_project_users
- Tasks: get_project_tasks, get_user_assigned_tasks, get_user_action_required_tasks, get_task, and get_task_details with subtasks, custom fields and full metadata
- Task activity: get_task_messages for the comment thread, add_task_comment to add one, update_task_status to move a task on, create_task to open one with assignments, dates and priority
- Sprints: get_goodday_sprint_tasks by project and sprint, and get_goodday_sprint_summary for status distribution and key metrics
- Users: get_users and get_user
- get_goodday_smart_query answers plain-language project questions; search_goodday_tasks does semantic search over tasks; search_project_documents and get_document_content cover project documents
Requirements
A Goodday API token generated from your organisation's settings, handed to the server as an environment value. Python. Semantic task search expects a vector-search endpoint you host yourself; every other tool works without it.
Setup effort
One command plus a key — pip install goodday-mcp, then supply credentials
USE CASES
01
Getting a sprint's shape before standup
Take the summary with its status distribution, then look at the individual tasks only where it matters.
02
Finding out what is on someone's plate
Pull their assigned tasks and the ones actually waiting on them, which are not the same list.
03
Catching up on a task's history
Read the full detail including subtasks and custom fields, then the comment thread behind it.
04
Filing and moving work
Open a task with its assignee, deadline and priority, move it on when it lands, and leave the note explaining why.
05
Finding a task you can only describe
Search by meaning rather than by exact words, or ask the question in plain language.
06
Pulling up a project document
Search the project's documents and read the content of the one you need without switching apps.
21 tools
Listed in project docs. Your client may show a different list.
get_projectcreate_projectget_project_usersget_project_tasksget_user_assigned_tasksget_user_action_required_tasksget_taskget_task_detailsget_task_messagescreate_taskupdate_task_statusadd_task_commentget_goodday_sprint_tasksget_goodday_sprint_summaryget_usersget_userget_goodday_smart_querysearch_goodday_taskssearch_project_documentsget_document_contentBEFORE YOU INSTALL
What to know first
Tools you get
21 tools named in the project's documentation. search_goodday_tasks needs a vector database you set up yourself; the project supplies an optional n8n workflow that loads Goodday into Qdrant.
Requires
- goodday-mcp on PATH
- Python 3.10 or later
- GOODDAY_API_TOKEN in your environment
Where it runs
Both documented setups run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
pip install goodday-mcpMCP Clients
Claude Desktop — pip
CLAUDE DESKTOP — PIP · JSON
{
"mcpServers": {
"goodday": {
"command": "goodday-mcp",
"env": {
"GOODDAY_API_TOKEN": "<YOUR_GOODDAY_API_TOKEN>"
}
}
}
}Claude Desktop — uv
CLAUDE DESKTOP — UV · JSON
{
"mcpServers": {
"goodday": {
"command": "uv",
"args": [
"run",
"goodday-mcp"
],
"env": {
"GOODDAY_API_TOKEN": "<YOUR_GOODDAY_API_TOKEN>"
}
}
}
}
