Agileday MCP Server

A Model Context Protocol (MCP) server for Agileday.

This server bridges Agileday's competence and employee data with LLMs (like Claude Desktop). It allows you to ask natural language questions about your organization's skills, finding experts, and viewing competence profiles without leaving your chat interface.

Capabilities

This server implements the following tools:

• find_experts_with_skill: Search for employees who possess a specific skill or competence (e.g., "Who knows React?").
• get_employee_competence_profile: Retrieve a full list of skills and proficiency levels for a specific employee.

Prerequisites

• Agileday Account: You need an active Agileday workspace.
• API Token: An API Bearer token from Agileday.
• Tenant ID: Your company slug (e.g., if your URL is acme.agileday.io, your tenant ID is acme).
• MCP Client: An application that supports MCP, such as Claude Desktop.

Configuration

The server requires the following environment variables:

Installation & Usage

You can run this server using Docker (recommended) or directly with Python.

Option 1: Docker (Recommended)

1. Clone the repository:

   git clone [https://github.com/yourusername/agileday-mcp-server.git](https://github.com/yourusername/agileday-mcp-server.git)
   cd agileday-mcp-server
   

2. Build the image:

   docker build -t agileday-mcp-server .
   

3. Configure Claude Desktop:
   Add the following to your claude_desktop_config.json (usually located at ~/Library/Application Support/Claude/ on macOS or %APPDATA%\Claude\ on Windows).

   {
     "mcpServers": {
       "agileday": {
         "command": "docker",
         "args": [
           "run",
           "-i",
           "--rm",
           "-e", "AGILEDAY_TENANT_ID=your_tenant_id",
           "-e", "AGILEDAY_API_TOKEN=your_api_token",
           "agileday-mcp-server"
         ]
       }
     }
   }
   

4. Restart Claude Desktop.

Option 2: Local Python

1. Clone the repository and install dependencies:

   git clone [https://github.com/yourusername/agileday-mcp-server.git](https://github.com/yourusername/agileday-mcp-server.git)
   cd agileday-mcp-server
   pip install -r requirements.txt
   

2. Configure Claude Desktop:
   Update your claude_desktop_config.json to point to the python script:

   {
     "mcpServers": {
       "agileday": {
         "command": "python3",
         "args": ["/absolute/path/to/agileday_server.py"],
         "env": {
           "AGILEDAY_TENANT_ID": "your_tenant_id",
           "AGILEDAY_API_TOKEN": "your_api_token"
         }
       }
     }
   }
   

Example Prompts

Once connected, you can ask Claude questions like:

• "Who are the experts in Python at our company?"
• "Find me someone who knows Service Design and has a high proficiency."
• "What is Jane Doe's competence profile?"
• "Do we have enough people with Kubernetes skills?"

Security Note

• API Tokens: Never commit your AGILEDAY_API_TOKEN to version control. Always pass it via environment variables or your local config file.
• ReadOnly Access: It is recommended to use an API token with read-only permissions if possible, as this tool only fetches data.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository.
2. Create your feature branch (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'Add some AmazingFeature').
4. Push to the branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

License

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