> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/grab/cursor-talk-to-figma-mcp/llms.txt
> Use this file to discover all available pages before exploring further.

# get_nodes_info

> Get detailed information about multiple nodes in Figma

## Overview

Retrieves comprehensive information about multiple nodes at once by their IDs. This is a batch version of `get_node_info` that efficiently fetches information for multiple nodes in a single operation.

## Parameters

<ParamField path="nodeIds" type="array" required>
  Array of node IDs to get information about. Each ID should be a string.

  ```typescript theme={null}
  nodeIds: ["123:456", "123:457", "123:458"]
  ```
</ParamField>

## Return Value

Returns an array of node information objects:

```json theme={null}
[
  {
    "id": "123:456",
    "name": "Header",
    "type": "FRAME",
    "fills": [...],
    "children": [...]
  },
  {
    "id": "123:457",
    "name": "Body Text",
    "type": "TEXT",
    "characters": "Welcome to our product",
    "style": {...}
  },
  {
    "id": "123:458",
    "name": "Button",
    "type": "FRAME",
    "fills": [...]
  }
]
```

## Usage Example

```typescript theme={null}
const nodesInfo = await use_mcp_tool({
  server_name: "TalkToFigma",
  tool_name: "get_nodes_info",
  arguments: {
    nodeIds: ["123:456", "123:457", "123:458"]
  }
});

nodesInfo.forEach(node => {
  console.log(`${node.name}: ${node.type}`);
  if (node.type === "TEXT") {
    console.log(`  Text: ${node.characters}`);
  }
});
```

## Best Practices

<Note>
  Use this tool instead of calling `get_node_info` multiple times. Batch operations are more efficient.
</Note>

<Warning>
  All node IDs must be valid. If any ID is invalid, the entire operation may fail.
</Warning>

## Performance Considerations

* Batch fetching is significantly faster than individual requests
* The tool processes all requests in parallel using `Promise.all`
* Each node is filtered through the same `filterFigmaNode` function as `get_node_info`

## Common Use Cases

* Inspecting multiple nodes discovered through scanning operations
* Batch analyzing children of a parent node
* Verifying properties of multiple nodes before batch modifications
* Collecting data from specific nodes in a design system

## Code Location

Source: `server.ts:313-348`

## Related Tools

* [get\_node\_info](/api/document-selection/get-node-info) - Get info for a single node
* [scan\_text\_nodes](/api/text-operations/scan-text-nodes) - Discover text nodes
* [scan\_nodes\_by\_types](/api/annotations/scan-nodes-by-types) - Discover nodes by type
