n8n

Connect One Horizon to your n8n workflows using the Model Context Protocol (MCP). Automate work logging, generate team reports, sync data between tools, and trigger actions based on One Horizon events—all within your n8n workflows.

What is One Horizon MCP?

One Horizon's MCP server exposes tools that let you interact with your work data programmatically. When used from n8n workflows, you can:

• Create and update tasks automatically
• Query planned work, completed work, and blockers
• Generate team recaps and reports
• List teams and find team members
• Sync data between One Horizon and other tools

Connecting n8n to One Horizon

Step 1: Add MCP Client Node

1. Open your n8n workflow
2. Add an MCP Client node (available in n8n 1.121.2+)
3. Configure the connection:

MCP Server URL:

https://mcp.onehorizon.ai/mcp

Authentication: MCP OAuth2

Credential:: MCP Account

Step 2: Authenticate

When you first execute the workflow with the MCP Client node, n8n will prompt you to authenticate. Follow the OAuth flow to log in and authorize the connection to One Horizon.

Available One Horizon Tools

Once connected, you can use these tools in your n8n workflows:

Work Management

• create-my-task - Create a new task (useful for logging completed work or planning)
• update-my-task - Update an existing task (mark as completed, update status, etc.)
• list-planned-work - Get planned work items (tasks, issues, calendar events)
• list-completed-work - Get completed work items (tasks and issues) from a date range
• list-blockers - Get blocked work items (tasks and issues)

Reports and Recaps

• my-work-recap - Get a comprehensive status report of your work (completed, planned, blocked)
• team-work-recap - Get a comprehensive status report of team member work

Team Management

• list-my-teams - List all teams you're a member of with team member details
• find-team-member - Find team members by name to get their userId and teamId

Tool Parameters Reference

create-my-task

Create a new task. Essential parameters:

• title (required): Concise title describing the work
• status (optional): "Completed", "Planned", "Blocked", "In Review" (defaults to "Planned")
• description (optional): Additional details about the work
• topic (required): 1-3 words describing the high-level purpose (e.g., "API", "UI", "Auth")
• completedAt (optional): ISO string for completion time (auto-set if status is "Completed")
• isNewFeature, isBugFix, isRefactor, etc. (optional): Boolean flags for categorization

list-completed-work

Get completed work items. Parameters:

• startDate (optional): ISO string, defaults to 24 hours ago
• endDate (optional): ISO string, defaults to now
• teamId (optional): Filter by team
• userId (optional): Filter by user (requires teamId)

list-planned-work

Get planned work items. Parameters:

• teamId (optional): Filter by team
• userId (optional): Filter by user (requires teamId)

team-work-recap

Get comprehensive team work report. Parameters:

• teamId (optional): Specific team, or omit for all teams
• startDate (optional): ISO string, defaults to 72 hours ago
• endDate (optional): ISO string, defaults to now

Security and Permissions

• Workflows execute with the permissions of the authenticated user
• You can only access data from workspaces and teams you're a member of
• Task creation and updates are scoped to your user account
• Review One Horizon workspace and team permissions to ensure workflows have appropriate access

Troubleshooting

Authentication Issues

• Ensure you've completed the OAuth flow when first using One Horizon tools
• Check that your n8n instance can access https://mcp.onehorizon.ai
• Try re-authenticating by removing and re-adding the MCP connection

Tool Execution Failures

• Verify the tool parameters match the expected format (see Tool Parameters Reference)
• Check that date strings are in ISO format (e.g., "2024-01-01T00:00:00Z")
• Ensure required parameters are provided (e.g., title and topic for create-my-task)

Data Access Issues

• Confirm you're a member of the workspace/team you're trying to access
• For team-specific queries, verify you're a member of that team
• Check that the userId and teamId parameters are correct

Connection Issues

• Verify the MCP endpoint URL is correct: https://mcp.onehorizon.ai/mcp
• Check network connectivity between n8n and One Horizon
• Review n8n workflow execution logs for detailed error messages