IdeaBlast MCP Server

Connect Claude to IdeaBlast to create ideas, brainstorm, manage your day, run boardroom meetings, and generate visual diagrams — from Claude Desktop or Claude Code.

20 tools for full bidirectional sync between Claude and IdeaBlast.

Requirements

• OS: Windows or macOS (desktop only — not mobile or Linux)
• Node.js v18+ installed (download)
• Claude Desktop (download) or Claude Code (CLI)
• IdeaBlast open in a browser on the same PC where the MCP server runs

Note: MCP is a local protocol. The MCP server runs on your machine and communicates via localhost. Claude mobile app does NOT support MCP.

Install from npm

npm install -g ideablast-mcp-server

Configure Claude Desktop

Add to your Claude Desktop config file:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

{
  "mcpServers": {
    "ideablast": {
      "command": "C:\\Users\\YOUR_USERNAME\\AppData\\Roaming\\npm\\ideablast-mcp.cmd",
      "args": [],
      "env": {}
    }
  }
}

Replace YOUR_USERNAME with your Windows user. Run echo %USERNAME% to find it.

macOS

{
  "mcpServers": {
    "ideablast": {
      "command": "ideablast-mcp",
      "args": [],
      "env": {}
    }
  }
}

Configure Claude Code

claude mcp add ideablast node /path/to/IdeaBlast/mcp-server/dist/index.js

Available Tools (20)

Create

| Tool | Description | Key Parameters | |------|-------------|----------------| | create_idea | Create a single idea | text, tags?, deadline? | | brainstorm | Generate multiple ideas about a topic | topic, ideas[] with { text, tags? } | | create_sticky_note | Create a sticky note on the Daily Board | text, color? (yellow/pink/green/blue/orange/purple) | | daily_plan | Create a set of sticky notes to plan your day | tasks[] with { text, category? } | | create_kanban_card | Add a task card to a Kanban board | title, column?, description?, priority? |

Read

| Tool | Description | Key Parameters | |------|-------------|----------------| | read_ideas | List all ideas with filtering/sorting | status?, tags?, created_after?, created_before?, sort_by?, sort_order? | | search_ideas | Full-text search across ideas | query, tags?, status?, date range params | | get_stats | Productivity statistics | from?, to? (date range) | | weekly_summary | Weekly activity review | — | | read_daily_notes | Read today's Daily Board notes | — | | read_kanban_cards | Read all Kanban cards by board/column | — | | read_boardroom_sessions | List all Virtual Boardroom meetings | — | | read_boardroom_plan | Extract action plans with Claude/User tasks | session_id? |

Update

| Tool | Description | Key Parameters | |------|-------------|----------------| | update_idea | Toggle done/favorite, edit, add tags, delete, set deadline | id, action, payload? | | update_daily_note | Toggle done, edit text, or delete a daily note | id, action, payload? | | update_kanban_card | Move columns, edit title/description, or delete | id, action, payload? | | bulk_update_ideas | Batch operations on multiple ideas | ids[], action |

Nexus (Thinking Room)

| Tool | Description | Key Parameters | |------|-------------|----------------| | inject_nexus_diagram | Generate a mind map, flowchart, or visual diagram inside an idea's Nexus canvas | idea_id, nodes[], edges[] |

Node types: circle, square, diamond, text Edge features: labels, animated connections

Example — Claude can generate a mind map:

"Create a mind map for idea xyz with the main concept in the center
and branches for Marketing, Development, and Finance"

The diagram appears in the idea's Nexus Thinking Room, fully editable by the user.

Management

| Tool | Description | |------|-------------| | list_pending | Show items waiting to sync | | clear_pending | Clear the sync queue |

How It Works

Claude Desktop ──stdio──▶ MCP Server (localhost:3456) ◀──HTTP poll── IdeaBlast (browser)

1. Claude → MCP Server: Claude calls tools via stdio (JSON-RPC)
2. Creates go to data/inbox.json → browser polls and imports them
3. Updates go to data/actions.json → browser polls and applies them
4. Reads use data/snapshot.json → browser pushes state every 5s
5. All communication is localhost only — zero cloud, zero tracking

Enable MCP Sync in IdeaBlast

1. Open IdeaBlast in your browser
2. Click the Plug icon in the header (or find "MCP Sync" in the More menu on mobile)
3. The icon turns green when connected to the MCP server

HTTP API (for debugging)

The MCP server runs an HTTP bridge on http://127.0.0.1:3456:

| Endpoint | Method | Description | |----------|--------|-------------| | /api/health | GET | Server status | | /api/snapshot | POST | Push idea/daily/kanban/boardroom state | | /api/inbox | GET | Pending items | | /api/inbox/:id | DELETE | Remove an item | | /api/actions | GET | Queued updates | | /api/actions/:id | DELETE | Acknowledge an action | | /api/events | GET (SSE) | Real-time event stream |

Update to Latest

npm install -g ideablast-mcp-server@latest

After updating, restart Claude Desktop and open a new conversation.

Development

cd mcp-server
npm install
npm run dev   # Run with tsx (no build needed)
npm run build # Build TypeScript
npm start     # Run built version

Adding New Tools

Create a new file in src/tools/:

import { add } from '../actions.js'
import { getSnapshot } from '../inbox.js'
import type { ToolDefinition } from './index.js'

export const myTool: ToolDefinition = {
  name: 'my_tool',
  description: 'What this tool does',
  inputSchema: {
    type: 'object',
    properties: { /* ... */ },
    required: ['text'],
  },
  handler: async (args) => {
    // Your logic here
    return { content: [{ type: 'text', text: 'Result' }] }
  },
}

Then import and add it to the allTools array in src/tools/index.ts.