# Personal Connector Tool Object

div
strong
🔨 In Development
 — This section is still being developed and may change.


Represents a tool available from a personal connector. Tools are MCP-compliant functions that can be executed by AI assistants to interact with external services.

## Properties

**`name`** string

Unique tool name. Format: `{connector}_{action}`. Examples: `clickup_create_task`, `github_create_issue`, `jira_list_issues`.

**`description`** string

Human-readable description of what the tool does. Used by AI models to determine when to use the tool.

**`inputSchema`** object

JSON Schema defining the tool's input parameters.

details
summary
Show input schema structure
**`type`** string

Always `object` for tool parameters.

**`properties`** object

Object defining each parameter with its type, description, and constraints.

**`required`** array of strings

List of required parameter names.

**Example:**


```json
{
  "type": "object",
  "properties": {
    "taskName": {
      "type": "string",
      "description": "Name of the task to create"
    },
    "priority": {
      "type": "integer",
      "description": "Task priority (1-4)",
      "minimum": 1,
      "maximum": 4
    }
  },
  "required": ["taskName"]
}
```

## Example Tools

### ClickUp Create Task


```json
{
  "name": "clickup_create_task",
  "description": "Create a new task in ClickUp with specified details",
  "inputSchema": {
    "type": "object",
    "properties": {
      "listId": {
        "type": "string",
        "description": "ClickUp list ID where the task will be created"
      },
      "name": {
        "type": "string",
        "description": "Task name/title"
      },
      "description": {
        "type": "string",
        "description": "Detailed task description"
      },
      "priority": {
        "type": "integer",
        "description": "Task priority (1=urgent, 2=high, 3=normal, 4=low)",
        "minimum": 1,
        "maximum": 4
      },
      "assignees": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Array of user IDs to assign to the task"
      }
    },
    "required": ["listId", "name"]
  }
}
```

### GitHub Create Issue


```json
{
  "name": "github_create_issue",
  "description": "Create a new issue in a GitHub repository",
  "inputSchema": {
    "type": "object",
    "properties": {
      "repository": {
        "type": "string",
        "description": "Repository in format 'owner/repo'"
      },
      "title": {
        "type": "string",
        "description": "Issue title"
      },
      "body": {
        "type": "string",
        "description": "Issue description/body"
      },
      "labels": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Array of label names"
      },
      "assignees": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Array of GitHub usernames to assign"
      }
    },
    "required": ["repository", "title"]
  }
}
```

### Jira List Issues


```json
{
  "name": "jira_list_issues",
  "description": "List issues from a Jira project using JQL query",
  "inputSchema": {
    "type": "object",
    "properties": {
      "projectKey": {
        "type": "string",
        "description": "Jira project key (e.g., 'PROJ')"
      },
      "jql": {
        "type": "string",
        "description": "JQL query to filter issues"
      },
      "maxResults": {
        "type": "integer",
        "description": "Maximum number of results to return",
        "default": 50,
        "minimum": 1,
        "maximum": 100
      }
    },
    "required": ["projectKey"]
  }
}
```