MCP Server

Convictional exposes a Model Context Protocol (MCP) server that lets your MCP-capable app access your organizational data including goals, tasks, posts, and more.

What You Can Do

Once connected, your AI assistant can:

• Goals: List, search, and retrieve goals and subgoals, including comments
• Tasks: List, search, and retrieve tasks and subtasks, including comments
• Meetings: Search across meetings content and data
• Emails: Search across meetings content, shared emails, and assignments
• Posts: Search posts content and comments
• Account info: Identify the currently authenticated user

Server URL

https://convictional.com/mcp

Authentication

The MCP server uses Google OAuth. When you connect for the first time, your AI client will open a browser window to complete a Google sign-in — use the same Google account you use to log into Convictional.

Connect with Claude Desktop

1. Open your Settings, and navigate to Connectors > Add custom connector
2. Add https://convictional.com/mcp

Alternatively:

1. Open your Claude Desktop configuration file:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. Add the Convictional server under mcpServers:

{
  "mcpServers": {
    "convictional": {
      "url": "https://convictional.com/mcp"
    }
  }
}

3. Save the file and restart Claude Desktop.
4. On first use, Claude Desktop will prompt you to authenticate with Google.

Connect with Claude Code

1. Run the following command in your terminal:

claude mcp add --transport http convictional https://convictional.com/mcp

2. Inside Claude Code, run /mcp to authenticate with Google.

Connect with Cursor

1. Open your Cursor MCP configuration file at .cursor/mcp.json in your project root (or the global config at ~/.cursor/mcp.json).
2. Add the Convictional server:

{
  "mcpServers": {
    "convictional": {
      "url": "https://convictional.com/mcp"
    }
  }
}

3. Restart Cursor and authenticate with Google when prompted.

Verify the Connection

Ask your AI assistant: "Who am I in Convictional?" or "List my open goals." A successful response confirms the connection is working.

Need Help?

If you run into issues during setup, reach out to our support team and we'll be happy to help.