Model Context Protocol

Let your AI
manage your ideas.

IdeasBox exposes an MCP server so Claude Code, or any MCP-compatible client, can create, edit, and manage your ideas and inspiration.

Setup

Add the IdeasBox MCP server to your Claude Code configuration.

1

Add the MCP server

Run this in your terminal:

claude mcp add --scope user ideasbox -- \
  npx -y @ideasbox/mcp
2

Approve the connection

On first use, Claude Code will print a URL. Open it in your browser, sign in to IdeasBox, and click Approve. That's it — you won't be asked again.

3

Start using it

Ask Claude to capture inspiration, develop an idea, or manage your existing content. It has full access to your IdeasBox account.

Available tools

The MCP server gives your AI full access to your IdeasBox account.

read_before_use

Returns usage instructions and conventions. Must be called first.

list_ideas

List all your finished ideas with word counts and timestamps.

list_inspiration

List all your unfinished inspiration.

create_idea

Create a new finished idea with a name and content.

create_inspiration

Capture rough inspiration or an unfinished thought.

promote_inspiration

Promote inspiration to a finished idea when it's ready.

get_idea

Read a specific idea or inspiration's full content.

update_idea

Update an idea or inspiration's name, content, or status.

delete_idea

Permanently delete an idea or inspiration.

get_settings

Read your settings (words per minute).

update_settings

Change your reading speed setting.

Security

Device auth flow

You approve every connection in your browser. No tokens are shared in the terminal.

Revocable tokens

Tokens are hashed and stored server-side. Revoke access instantly from your account.

No passwords stored

Authentication uses your existing IdeasBox login. The MCP server never sees your password.

Ready to connect?

Set up in under a minute. One command, one approval.

claude mcp add --scope user ideasbox -- \
  npx -y @ideasbox/mcp