Tools Reference - emma Documentation

This page provides detailed documentation for all tools available in the emma MCP Server.

Task Execution

emma_run_task

Execute a task on emma.

prompt

string

required

The task description to execute. Be specific and clear.Examples:

"Post today's weather to Slack #general"
"Summarize the latest GitHub issues"
"Send a reminder email to the team about tomorrow's meeting"

mode

string

default:"normal"

Execution mode for the task.

Value	Description
`normal`	Standard execution (default)
`deep_thinking`	Extended reasoning for complex tasks
`ask`	Information gathering mode

timezone

string

default:"Asia/Tokyo"

Timezone in IANA format (e.g., America/New_York, Europe/London).

Example Request
Example Response

{
  "prompt": "Post today's weather forecast to Slack #general",
  "mode": "normal",
  "timezone": "Asia/Tokyo"
}

{
  "success": true,
  "task_id": "task_abc123",
  "message": "Task executed successfully"
}

emma_health_check

Check emma API connection status. This tool takes no parameters.

Example Request
Example Response

{}

{
  "status": "healthy",
  "api_version": "1.0.0",
  "timestamp": "2024-01-15T10:30:00Z"
}

Automation Management

emma_create_automation

Create a new scheduled automation.

name

string

required

Name for the automation.Examples: "Daily Health Digest", "Weekly Report", "Hourly Status Check"

prompt

string

required

The task prompt that emma will execute on schedule.

cron_expression

string

required

Cron expression defining the schedule.Common patterns:

Expression	Description
`0 9 * * *`	Every day at 9:00 AM
`0 9 * * 1`	Every Monday at 9:00 AM
`0 /2 * *`	Every 2 hours
`0 9 1 * *`	First day of every month at 9:00 AM

timezone

string

default:"Asia/Tokyo"

Timezone for the schedule in IANA format.

enabled

boolean

default:true

Whether the automation should be enabled immediately.

Example Request
Example Response

{
  "name": "Daily Standup Reminder",
  "prompt": "Send a standup reminder to Slack #team",
  "cron_expression": "0 9 * * 1-5",
  "timezone": "Asia/Tokyo",
  "enabled": true
}

{
  "success": true,
  "automation_id": "sched_abc123",
  "name": "Daily Standup Reminder",
  "next_run": "2024-01-16T09:00:00+09:00"
}

emma_list_automations

List all automations for the user.

timezone

string

default:"Asia/Tokyo"

Timezone for displaying schedule times.

Example Request
Example Response

{
  "timezone": "Asia/Tokyo"
}

{
  "automations": [
    {
      "automation_id": "sched_abc123",
      "name": "Daily Standup Reminder",
      "cron_expression": "0 9 * * 1-5",
      "enabled": true,
      "next_run": "2024-01-16T09:00:00+09:00"
    },
    {
      "automation_id": "sched_def456",
      "name": "Weekly Report",
      "cron_expression": "0 10 * * 1",
      "enabled": true,
      "next_run": "2024-01-22T10:00:00+09:00"
    }
  ],
  "total": 2
}

emma_get_automation

Get details of a specific automation.

automation_id

string

required

The automation ID (e.g., "sched_abc123").

timezone

string

default:"Asia/Tokyo"

Timezone for displaying schedule times.

Example Request
Example Response

{
  "automation_id": "sched_abc123",
  "timezone": "Asia/Tokyo"
}

{
  "automation_id": "sched_abc123",
  "name": "Daily Standup Reminder",
  "prompt": "Send a standup reminder to Slack #team",
  "cron_expression": "0 9 * * 1-5",
  "timezone": "Asia/Tokyo",
  "enabled": true,
  "created_at": "2024-01-10T14:30:00+09:00",
  "next_run": "2024-01-16T09:00:00+09:00",
  "last_run": "2024-01-15T09:00:00+09:00"
}

emma_update_automation

Update an existing automation. Only specified fields will be updated.

automation_id

string

required

The automation ID to update.

name

string

New name for the automation.

prompt

string

New task prompt.

cron_expression

string

New cron expression.

timezone

string

New timezone.

enabled

boolean

Enable or disable the automation.

Example Request
Example Response

{
  "automation_id": "sched_abc123",
  "cron_expression": "0 10 * * 1-5",
  "enabled": false
}

{
  "success": true,
  "automation_id": "sched_abc123",
  "updated_fields": ["cron_expression", "enabled"],
  "next_run": null
}

emma_delete_automation

Delete an automation. This action cannot be undone.

automation_id

string

required

The automation ID to delete.

Deleting an automation is permanent and cannot be undone.

Example Request
Example Response

{
  "automation_id": "sched_abc123"
}

{
  "success": true,
  "message": "Automation 'Daily Standup Reminder' has been deleted"
}

Cron Expression Reference

Cron expressions follow the standard 5-field format:

┌───────────── minute (0-59)
│ ┌───────────── hour (0-23)
│ │ ┌───────────── day of month (1-31)
│ │ │ ┌───────────── month (1-12)
│ │ │ │ ┌───────────── day of week (0-6, Sunday=0)
│ │ │ │ │
* * * * *

Common Examples

Expression	Description
`0 9 * * *`	Every day at 9:00 AM
`0 9 * * 1-5`	Weekdays at 9:00 AM
`0 9 * * 0`	Every Sunday at 9:00 AM
`0 /2 * *`	Every 2 hours
`30 8 * * *`	Every day at 8:30 AM
`0 9 1 * *`	First day of month at 9:00 AM
`0 9 * * 1`	Every Monday at 9:00 AM
`0 0 * * *`	Every day at midnight

Special Characters

Character	Description	Example
`*`	Any value	`* * * * *` (every minute)
`,`	List separator	`0 9,12,18 * * *` (9 AM, 12 PM, 6 PM)
`-`	Range	`0 9 * * 1-5` (Monday to Friday)
`/`	Step	`/15 * * *` (every 15 minutes)

​Task Execution

​emma_run_task

​emma_health_check

​Automation Management

​emma_create_automation

​emma_list_automations

​emma_get_automation

​emma_update_automation

​emma_delete_automation

​Cron Expression Reference

​Common Examples

​Special Characters

Task Execution

emma_run_task

emma_health_check

Automation Management

emma_create_automation

emma_list_automations

emma_get_automation

emma_update_automation

emma_delete_automation

Cron Expression Reference

Common Examples

Special Characters