Linear MCP Server

Instructions

Implementation Reference

• src/index.ts:310-329 (handler)

  The handler function that fetches all users from the Linear workspace using the LinearClient, formats them into a list with id, name, email, displayName, and active status, and returns them as a JSON string in the MCP content format.

  private async handleGetUsers() {
    const users = await linearClient.users();
    
    const formattedUsers = users.nodes.map(user => ({
      id: user.id,
      name: user.name,
      email: user.email,
      displayName: user.displayName,
      active: user.active,
    }));
  
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(formattedUsers, null, 2),
        },
      ],
    };
  }

• src/index.ts:100-107 (registration)

  Registration of the 'get_users' tool in the listTools response, including its name, description, and input schema (no required parameters).

  {
    name: 'get_users',
    description: 'Get a list of users in the Linear workspace',
    inputSchema: {
      type: 'object',
      properties: {},
    },
  },

• src/index.ts:103-107 (schema)

  Input schema for the get_users tool, defined as an empty object (no parameters required).

    inputSchema: {
      type: 'object',
      properties: {},
    },
  },

• src/index.ts:120-121 (handler)

  Dispatch case in the CallToolRequest handler that routes 'get_users' tool calls to the handleGetUsers method.

  case 'get_users':
    return await this.handleGetUsers();