sharelist-mcp

Bridge between Claude Desktop and Share List MCP HTTP server.

Installation

You don't need to install this package manually. Claude Desktop will download it automatically when you add the configuration.

Configuration

Add this to your Claude Desktop config file:

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

{
  "mcpServers": {
    "sharelist": {
      "command": "npx",
      "args": ["sharelist-mcp"],
      "env": {
        "MCP_SERVER_URL": "https://sharelist.ai/api/mcp/v1",
        "MCP_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

Getting a Token

1. Visit https://sharelist.ai/settings/mcp
2. Generate a new token
3. Replace YOUR_TOKEN_HERE with your token

Available Tools (v2.0.0)

All tools are namespaced with sharelist_ to prevent conflicts with other MCP servers:

• sharelist_get_lists - Get all your shared lists
• sharelist_read_data - Read data from a specific list with schema info
• sharelist_update_cell - Update a specific cell value
• sharelist_update_batch - Update multiple cells efficiently
• sharelist_search - Search for records in a list
• sharelist_analyze_column - Analyze column data patterns
• sharelist_read_filtered - Read filtered data with pagination

Version 2.0.0 Breaking Changes

All tool names have been namespaced. Claude will automatically discover the new names, but if you have any custom prompts referencing the old tool names, you'll need to update them.

Using with Claude Desktop

Once configured, you can ask Claude natural questions like:

• "What lists do I have?"
• "Show me the data in my customer list"
• "Update the phone number for John Doe"
• "Search for all orders from last month"

Claude will automatically use the appropriate ShareList tools.

Troubleshooting

1. Check Claude Desktop logs:

   • macOS: ~/Library/Logs/Claude/
   • Windows: %APPDATA%\Claude\logs\

2. Bridge logs are written to stderr and will appear in Claude's logs

3. Common issues:

   • Ensure the path to index.js is absolute
   • Check that the MCP server URL is accessible
   • Verify the token is valid