tasker-mcp

MCP.Pizza Chef: dceluis

Tasker MCP is an MCP server designed to integrate with Android's Tasker automation app, allowing real-time interaction and control of Tasker tasks via the MCP protocol. It provides a secure API key mechanism and supports running on various device architectures, enabling seamless automation workflows on Android devices through MCP-compatible clients and hosts.

Unmaintained · No commits in 19 months.

Use This MCP server To

Integrate Android Tasker with MCP-enabled LLM hosts Trigger Tasker tasks remotely via MCP protocol Automate Android device workflows using LLM commands Generate and manage API keys for secure Tasker access Run MCP server on Android devices with different architectures Enable real-time Tasker task updates through MCP Use CLI server binaries to control Tasker from PCs or phones

README

Tasker MCP

This document will guide you through setting up and running the Tasker MCP integration, including instructions for installing dependencies, preparing servers, and updating tasks.


Usage Guide

Step 1: Import the Tasker Profile

  • Import dist/mcp_server.prj.xml into your Tasker app.
  • After importing, run the MCP generate_api_key task to generate an API key for secure access.

Step 2: Select and Run Your Server

CLI Server:

  • From the dist/ folder, select the correct CLI server binary for your device's architecture, such as tasker-mcp-server-cli-aarch64.
  • Copy both the binary and the toolDescriptions.json file to your device (phone or PC).
  • Rename the binary to mcp-server after copying.

Example:

Using scp:

scp dist/tasker-mcp-server-cli-aarch64 user@phone_ip:/data/data/com.termux/files/home/mcp-server

Using adb push:

adb push dist/tasker-mcp-server-cli-aarch64 /data/data/com.termux/files/home/mcp-server
  • Run the server in SSE mode with:
./mcp-server --tools /path/to/toolDescriptions.json --tasker-api-key=tk_... --mode sse
  • Or call it through the stdio transport:
payload='{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "tasker_flash_text", "arguments": { "text": "Hi" }  } }'
echo $payload | ./mcp-server --tools /path/to/toolDescriptions.json --tasker-api-key=tk_...
Command-Line Flags

The tasker-mcp-server-cli application accepts the following flags:

tasker-mcp FAQ

How do I generate an API key for Tasker MCP?
Import the Tasker profile and run the 'MCP generate_api_key' task within the Tasker app to create a secure API key.
What devices can run the Tasker MCP server?
The server supports multiple device architectures, including aarch64, and can run on Android phones or PCs with appropriate binaries.
How do I deploy the Tasker MCP server binary to my device?
Use tools like 'scp' or 'adb push' to copy the correct binary and 'toolDescriptions.json' to your device, then rename the binary to 'mcp-server'.
Is the Tasker MCP server compatible with multiple LLM providers?
Yes, it works with various LLM providers such as OpenAI, Claude, and Gemini through the MCP protocol.
Can I update Tasker tasks dynamically using this MCP server?
Yes, the server supports updating and running Tasker tasks in real time via MCP commands.
What is the purpose of the 'toolDescriptions.json' file?
It describes the available MCP tools and commands for the server, enabling clients to understand and interact with Tasker tasks.
Do I need to install any dependencies to run the Tasker MCP server?
Yes, follow the setup instructions in the documentation to install required dependencies and prepare your environment.
Can I run the Tasker MCP server on a PC?
Yes, the server binaries support PC architectures, allowing control of Tasker on Android devices remotely.