Skip to main content
Glama

goodday-mcp

by cdmx-in
MIT License
  • Apple

Goodday MCP Server

A Model Context Protocol (MCP) server for integrating with Goodday project management platform. This server provides tools for managing projects, tasks, and users through the Goodday API v2.

Features

Project Management

  • get_projects: Retrieve list of projects (with options for archived and root-only filtering)
  • get_project: Get detailed information about a specific project
  • create_project: Create new projects with customizable templates and settings
  • get_project_users: Get users associated with a specific project

Task Management

  • get_project_tasks: Retrieve tasks from specific projects (with options for closed tasks and subfolders)
  • get_user_assigned_tasks: Get tasks assigned to a specific user
  • get_user_action_required_tasks: Get action-required tasks for a user
  • get_task: Get detailed information about a specific task
  • create_task: Create new tasks with full customization (subtasks, assignments, dates, priorities)
  • update_task_status: Update task status with optional comments
  • add_task_comment: Add comments to tasks

User Management

  • get_users: Retrieve list of organization users
  • get_user: Get detailed information about a specific user

OpenWebUI Integration

This package also includes an OpenWebUI tool that provides a complete interface for Goodday project management directly in chat interfaces. The OpenWebUI tool includes:

Features

  • Project Management: Get projects and project tasks
  • Sprint Management: Get tasks from specific sprints by name/number
  • User Management: Get tasks assigned to specific users
  • Smart Query: Natural language interface for common requests
  • Search: Semantic search across tasks using VectorDB backend
  • Task Details: Get detailed task information and messages

Setup

  1. Copy openwebui/goodday_openwebui_complete_tool.py to your OpenWebUI tools directory
  2. Configure the valves with your API credentials:
    • api_key: Your Goodday API token
    • search_url: Your VectorDB search endpoint (optional)
    • bearer_token: Bearer token for search API (optional)

Vector Database Setup (Optional)

For semantic search functionality, you can set up a vector database using the provided n8n workflow (openwebui/n8n-workflow-goodday-vectordb.json). This workflow:

  • Fetches all Goodday projects and tasks
  • Extracts task messages and content
  • Creates embeddings using Ollama
  • Stores in Qdrant vector database
  • Provides search API endpoint

See openwebui/OPENWEBUI_TOOL_README.md for detailed usage instructions.

Installation

pip install goodday-mcp

From Source

Prerequisites
  • Python 3.10 or higher
  • UV package manager (recommended) or pip
  • Goodday API token
Setup with UV
  1. Install UV (if not already installed):
    curl -LsSf https://astral.sh/uv/install.sh | sh
  2. Clone and set up the project:
    git clone https://github.com/cdmx1/goodday-mcp.git cd goodday-mcp # Create virtual environment and install dependencies uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate uv sync
Setup with pip
git clone https://github.com/cdmx1/goodday-mcp.git cd goodday-mcp pip install -e .

Configuration

  1. Set up environment variables: Create a .env file in your project root or export the variable:
    export GOODDAY_API_TOKEN=your_goodday_api_token_here
    To get your Goodday API token:
    • Go to your Goodday organization
    • Navigate to Settings → API
    • Click the generate button to create a new token

Usage

Running the Server Standalone

If installed from PyPI:

goodday-mcp

If running from source with UV:

uv run goodday-mcp

Using with Claude Desktop

  1. Configure Claude Desktop by editing your configuration file:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Add the server configuration:Option A: If installed from PyPI:
    { "mcpServers": { "goodday": { "command": "goodday-mcp", "env": { "GOODDAY_API_TOKEN": "your_goodday_api_token_here" } } } }
    Option B: If running from source:
    { "mcpServers": { "goodday": { "command": "uv", "args": ["run", "goodday-mcp"], "env": { "GOODDAY_API_TOKEN": "your_goodday_api_token_here" } } } }
  3. Restart Claude Desktop to load the new server.

Using with Other MCP Clients

The server communicates via stdio transport and can be integrated with any MCP-compatible client. Refer to the MCP documentation for client-specific integration instructions.

API Reference

Environment Variables

VariableDescriptionRequired
GOODDAY_API_TOKENYour Goodday API tokenYes

Tool Examples

Get Projects
# Get all active projects get_projects() # Get archived projects get_projects(archived=True) # Get only root-level projects get_projects(root_only=True)
Create a Task
create_task( project_id="project_123", title="Implement new feature", from_user_id="user_456", message="Detailed description of the task", to_user_id="user_789", deadline="2025-06-30", priority=5 )
Update Task Status
update_task_status( task_id="task_123", user_id="user_456", status_id="status_completed", message="Task completed successfully" )

Data Formats

Date Format

All dates should be provided in YYYY-MM-DD format (e.g., 2025-06-16).

Priority Levels

  • 1-10: Normal priority levels
  • 50: Blocker
  • 100: Emergency

Project Colors

Project colors are specified as integers from 1-24, corresponding to Goodday's color palette.

Error Handling

The server includes comprehensive error handling:

  • Authentication errors: When API token is missing or invalid
  • Network errors: When Goodday API is unreachable
  • Validation errors: When required parameters are missing
  • Permission errors: When user lacks permissions for requested operations

All errors are returned as descriptive strings to help with troubleshooting.

Development

Project Structure

goodday-mcp/ ├── goodday_mcp/ # Main package directory │ ├── __init__.py # Package initialization │ └── main.py # Main MCP server implementation ├── pyproject.toml # Project configuration and dependencies ├── README.md # This file ├── LICENSE # MIT license ├── uv.lock # Dependency lock file └── .env # Environment variables (create this)

Adding New Tools

To add new tools to the server:

  1. Add the tool function in goodday_mcp/main.py using the @mcp.tool() decorator:
    @mcp.tool() async def your_new_tool(param1: str, param2: Optional[int] = None) -> str: """Description of what the tool does. Args: param1: Description of parameter 1 param2: Description of optional parameter 2 """ # Implementation here return "Result"
  2. Test the tool by running the server and testing with an MCP client.

Testing

Test the server by running it directly:

# If installed from PyPI goodday-mcp # If running from source uv run goodday-mcp

The server will start and wait for MCP protocol messages via stdin/stdout.

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests if applicable
  5. Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

For issues related to:

Changelog

v1.0.0

  • Initial release
  • Full project management capabilities
  • Task management with comments and status updates
  • User management
  • Comprehensive error handling
  • UV support with modern Python packaging
-
security - not tested
A
license - permissive license
-
quality - not tested

Goodday‑MCP is a lightweight Model Context Protocol (MCP) server designed to seamlessly integrate with the Goodday project management platform via its API v2. It enables querying of projects, tasks, and users—without altering any data—making it ideal for secure context-aware applications

  1. Features
    1. Project Management
    2. Task Management
    3. User Management
  2. OpenWebUI Integration
    1. Features
    2. Setup
    3. Vector Database Setup (Optional)
  3. Installation
    1. From PyPI (Recommended)
    2. From Source
    3. Configuration
  4. Usage
    1. Running the Server Standalone
    2. Using with Claude Desktop
    3. Using with Other MCP Clients
  5. API Reference
    1. Environment Variables
    2. Tool Examples
  6. Data Formats
    1. Date Format
    2. Priority Levels
    3. Project Colors
  7. Error Handling
    1. Development
      1. Project Structure
      2. Adding New Tools
      3. Testing
    2. Contributing
      1. License
        1. Support
          1. Changelog
            1. v1.0.0

          Related MCP Servers

          • -
            security
            F
            license
            -
            quality
            A specialized Model Context Protocol (MCP) server that integrates Google services (Gmail, Calendar, etc.) into your AI workflows. This server enables seamless access to Google services through MCP, allowing AI agents to interact with Gmail, Google Calendar, and other Google services.
            Last updated -
            10
            3
            TypeScript
          • A
            security
            A
            license
            A
            quality
            Model Context Protocol (MCP) is a new, standardized protocol for managing context between large language models (LLMs) and external systems. In this repository, we provide an installer as well as an MCP Server for Upstash Developer API's.
            Last updated -
            16
            58
            27
            TypeScript
            MIT License
            • Linux
            • Apple
          • A
            security
            F
            license
            A
            quality
            A Model Context Protocol (MCP) server that interacts with system APIs, allowing users to check connections, search employees, register breakfast, and update chemical information by shifts.
            Last updated -
            21
            76
            JavaScript
          • -
            security
            A
            license
            -
            quality
            A Model Context Protocol (MCP) server designed to easily dump your codebase context into Large Language Models (LLMs).
            Last updated -
            2
            1
            JavaScript
            Apache 2.0

          View all related MCP servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/cdmx-in/goodday-mcp'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server