Skip to content
/
Personal Connector Tool
Last updated

Personal Connector Tool Object

🔨 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.

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:

{
  "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

{
  "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

{
  "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

{
  "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"]
  }
}
Previous page
Next page