Skip to main content

​
Prerequisites

Before connecting, make sure you have:
  1. A Writesonic account with an active Business plan
  2. At least one project with tracked prompts in your dashboard

​
Claude.ai (Web)

  1. Go to Settings in Claude.ai
  2. Navigate to MCP Servers (or Integrations)
  3. Click Add MCP Server
  4. Enter the server URL: 
    https://mcp.writesonic.com/mcp
  5. Click Connect — you’ll be redirected to Writesonic to authorize access
  6. Sign in and approve the connection
  7. You’re ready to query your GEO data

​
Claude Desktop

Add the following to your claude_desktop_config.json: 
// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "writesonic": {
      "url": "https://mcp.writesonic.com/mcp"
    }
  }
}
Restart Claude Desktop after saving. On first use, you’ll be prompted to authenticate with Writesonic.

​
Claude Code (CLI)

Run in your terminal: 
claude mcp add writesonic --transport streamable-http https://mcp.writesonic.com/mcp
On first tool call, Claude Code will open a browser window for OAuth authentication.

​
Authentication

The MCP server uses OAuth 2.0 for authentication. When you first connect:
  1. Your client redirects you to the Writesonic login page
  2. Sign in with your Writesonic credentials
  3. Authorize the MCP integration to access your GEO data
  4. You’re redirected back — the session is now active
Sessions persist across conversations. You won’t need to re-authenticate unless your token expires.

​
Verifying the Connection

After setup, try this prompt in Claude:
“List my Writesonic projects”
Claude should call the get_all_projects tool and return your project list. If this works, you’re all set.

​
Troubleshooting

“Authentication failed” or redirect loop
  • Make sure you have an active Business plan
  • Try disconnecting and reconnecting the MCP server
  • Clear browser cookies for writesonic.com and retry
“No projects found”
  • Verify you have at least one project in your Writesonic dashboard
  • Ensure the project has tracked prompts configured
Tools not appearing
  • In Claude Desktop, restart the app after editing claude_desktop_config.json
  • In Claude Code, run claude mcp list to verify the server is registered