chatgrid-mcp

MCP server for ChatGrid — give your AI assistant access to your team's project knowledge boards.

Works with Claude Code, Claude Desktop, and any MCP-compatible client.

Quick start

npx chatgrid-mcp

Setup

1. Get your API key

Go to chatgrid.ai/settings/api-keys and create an API key.

2. Configure Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "chatgrid": {
      "command": "npx",
      "args": ["-y", "chatgrid-mcp"],
      "env": {
        "CHATGRID_API_KEY": "your-api-key-here"
      }
    }
  }
}

Or for Claude Desktop, add to claude_desktop_config.json:

{
  "mcpServers": {
    "chatgrid": {
      "command": "npx",
      "args": ["-y", "chatgrid-mcp"],
      "env": {
        "CHATGRID_API_KEY": "your-api-key-here"
      }
    }
  }
}

Environment variables

| Variable | Required | Description | | ------------------ | -------- | -------------------------------------------------------------- | | CHATGRID_API_KEY | Yes | Your ChatGrid API key | | CHATGRID_API_URL | No | Override the API base URL (default: https://api.chatgrid.ai) |

Available tools

Board Management

list_boards

List all boards the user has access to.

Example: "What boards do I have on ChatGrid?"

create_board

Create a new project board.

| Parameter | Type | Required | Description | | --------- | ------ | -------- | ---------------------- | | name | string | Yes | Name for the new board |

Example: "Create a new ChatGrid board called 'Backend Architecture'"

Knowledge Management

add_resource

Add a YouTube video, URL, or text document to a board. Automatically vectorizes the content for AI search.

| Parameter | Type | Required | Description | | ---------- | ---------------------------------- | -------- | ------------------------------- | | board_id | string | Yes | Board ID to add the resource to | | type | "youtube" | "url" | "text" | Yes | Resource type | | content | string | Yes | URL or text content | | label | string | No | Optional label for the resource |

Example: "Add this YouTube video to my Architecture board: https://youtube.com/watch?v=..."

search_board

Semantic search across all content on a board.

| Parameter | Type | Required | Description | | ---------- | ------ | -------- | ----------------------------- | | board_id | string | Yes | Board ID to search | | query | string | Yes | Search query | | limit | number | No | Max results (1-20, default 5) |

Example: "Search my Architecture board for anything about database sharding"

ask_board

Ask an AI question grounded in the board's knowledge. Searches the board first, then generates an answer based on the found content.

| Parameter | Type | Required | Description | | ---------- | ------ | -------- | --------------------- | | board_id | string | Yes | Board ID to ask about | | question | string | Yes | Question to ask |

Example: "Based on my Architecture board, what database should we use for the user service?"

Node Operations

add_note

Add a quick note, decision, or learning to a board.

| Parameter | Type | Required | Description | | ---------- | ------ | -------- | --------------------------- | | board_id | string | Yes | Board ID to add the note to | | content | string | Yes | Note content | | label | string | No | Optional label |

Example: "Add a note to my Architecture board: Decided to use PostgreSQL for the user service"

list_nodes

List all nodes on a board with their types and labels.

| Parameter | Type | Required | Description | | ---------- | ------ | -------- | -------------------------- | | board_id | string | Yes | Board ID to list nodes for |

Example: "What's on my Architecture board?"

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

License

MIT