# MCP Server ### Overview The SmartTask MCP Server allows AI assistants and MCP-compatible clients to securely interact with SmartTask workspaces using natural language. The current MCP server capabilities focus on: * Organization management * Task management * Project search * User and group lookup * Task collaboration * Reporting and summaries *** ## Organization Management Users can manage and switch between organizations connected to their SmartTask account. ### Available Capabilities #### Get Active Organization Retrieve the currently active organization for the MCP session. #### List Organizations View all organizations the user belongs to. #### Switch Active Organization Change the active organization context for future actions. ### Example Prompts * “What organization am I currently using?” * “Show all my organizations” * “Switch to Acme Inc workspace” *** ## Task Management The MCP server provides comprehensive task management capabilities. ### Create Tasks Users can create new tasks using natural language. #### Supported Inputs * Task name * Description * Assignee * Project * Start date * Due date * Date range #### Example Prompts * “Create a task called Homepage Redesign due next Friday” * “Create a bug fix task and assign it to Rahul” * “Create onboarding task for next week” *** ### Retrieve Tasks Users can fetch tasks using filters and search queries. #### Supported Filters * Assignee * Creator * Group * Project * Status * Overdue tasks * Start date * Due date * Completion date * Creation date * Modification date #### Example Prompts * “Show my overdue tasks” * “List completed tasks from this month” * “Get tasks due next week” * “Show pending tasks in Mobile App project” *** ### Search Tasks Users can search tasks by task name. #### Example Prompts * “Find task related to API integration” * “Search for onboarding tasks” * “Find homepage redesign task” *** ### Get Task Details Retrieve full information for a specific task. #### Example Prompts * “Open the Website QA task” * “Show details of the deployment task” *** ### Update Task Status Mark tasks as complete or incomplete. #### Example Prompts * “Mark homepage redesign as completed” * “Reopen the API testing task” *** ### Update Task Assignee Assign or reassign tasks to users. #### Example Prompts * “Assign the bug fix task to Neha” * “Move onboarding task to Rahul” *** ### Update Due Dates Modify task due dates. #### Example Prompts * “Move the deadline to next Monday” * “Extend the due date by 3 days” *** ### Add Tasks to Projects Attach existing tasks to one or more projects. #### Example Prompts * “Add onboarding task to HR project” * “Attach deployment task to Release Management” *** ## Project Search Users can search for projects within the active organization. ### Example Prompts * “Find projects related to mobile app” * “Search for website redesign project” * “Show projects containing CRM” *** ## User Search Users can search organization members by name or email. ### Example Prompts * “Find Rahul Shah” * “Search user by email” * “Who is working in design team?” *** ## Group Search Users can search for groups or teams within the organization. ### Example Prompts * “Find Engineering group” * “Search Marketing team” * “Show QA groups” *** ## Comments & Collaboration The MCP server supports task and contact collaboration features. ### Add Comments Users can add comments to tasks or contacts. #### Example Prompts * “Add a comment saying QA completed” * “Comment that deployment is blocked” * “Notify team about API changes” *** ### Retrieve Activity History Users can retrieve recent activities for tasks or contacts. #### Example Prompts * “Show recent updates on deployment task” * “Get activity history for onboarding task” * “Who updated this task recently?” *** ## Reporting & Summaries The MCP server can generate summaries and reports for tasks. ### Supported Reporting Features * Task summaries * Project-based grouping * User-based grouping * Overdue task reporting * Status summaries * Date-range summaries ### Example Prompts * “Summarize all pending tasks” * “Show overdue tasks grouped by user” * “Get project-wise task summary” * “Summarize completed work from this month” *** ## Supported Workflow Examples ### Daily Task Review Users can ask: > “Show my overdue and pending tasks” The MCP server can: * Retrieve incomplete tasks * Filter overdue work * Group tasks by project or priority *** ### Team Coordination Users can ask: > “Assign onboarding tasks to HR team members” The MCP server can: * Search users/groups * Update assignees * Add collaboration comments *** ### Project Tracking Users can ask: > “Summarize tasks in Website Redesign project” The MCP server can: * Fetch project tasks * Group by status or assignee * Generate progress summaries *** ## Security & Access Control The SmartTask MCP server respects SmartTask workspace permissions. Users can only: * Access organizations they belong to * View authorized tasks/projects * Modify records they have permission to edit All actions operate within the active organization context. *** ## Supported MCP Operations ### Organization Operations * organization\_get\_active * organization\_get\_list * organization\_set\_active ### Task Operations * task\_create * task\_get\_list * task\_get\_one * task\_search * task\_update\_status * task\_update\_assignee * task\_update\_date\_info * task\_add\_to\_projects ### Collaboration Operations * record\_add\_comment * record\_get\_activities ### Search Operations * project\_search * user\_search * group\_search ### Reporting Operations * report\_summary *** ## Conclusion The SmartTask MCP Server enables users to manage tasks, collaborate with teams, search workspace data, and generate summaries through natural language interactions inside MCP-compatible AI assistants. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://guide.smarttask.io/advanced/mcp-server.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.