{"id":38707340,"url":"https://github.com/itsbrex/attio-mcp-server","last_synced_at":"2026-01-17T10:57:27.782Z","repository":{"id":298590359,"uuid":"1000485622","full_name":"itsbrex/attio-mcp-server","owner":"itsbrex","description":"Model Context Protocol server for Attio CRM - enables Claude Desktop and Cursor to interact with your Attio workspace","archived":false,"fork":false,"pushed_at":"2025-06-11T21:45:18.000Z","size":446,"stargazers_count":7,"open_issues_count":3,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-25T18:44:47.985Z","etag":null,"topics":["ai","api","assistant","attio","claude","crm","cursor","mcp","model-context-protocol","typescript"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/itsbrex.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-11T21:30:01.000Z","updated_at":"2025-09-28T06:11:44.000Z","dependencies_parsed_at":"2025-06-11T22:40:18.819Z","dependency_job_id":"a1748f4e-7b8a-43e7-b680-be96f8b8247c","html_url":"https://github.com/itsbrex/attio-mcp-server","commit_stats":null,"previous_names":["itsbrex/attio-mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/itsbrex/attio-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsbrex%2Fattio-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsbrex%2Fattio-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsbrex%2Fattio-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsbrex%2Fattio-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/itsbrex","download_url":"https://codeload.github.com/itsbrex/attio-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsbrex%2Fattio-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28506593,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T10:25:30.148Z","status":"ssl_error","status_checked_at":"2026-01-17T10:25:29.718Z","response_time":85,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","api","assistant","attio","claude","crm","cursor","mcp","model-context-protocol","typescript"],"created_at":"2026-01-17T10:57:27.703Z","updated_at":"2026-01-17T10:57:27.773Z","avatar_url":"https://github.com/itsbrex.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Attio MCP Server\n\nA high-performance Model Context Protocol (MCP) server that provides seamless access to the Attio API, enabling AI assistants like Claude and Cursor to interact with your Attio workspace through human-readable tools.\n\n## Features\n\n- **🏷️ Human-Readable Tool Names**: Automatically transforms technical API names (like `getv2objects`) into clear, categorized names (like `list_objects`)\n- **📊 Full API Coverage**: Access to objects, records, attributes, lists, tasks, notes, and more\n- **📁 Organized by Category**: Tools are grouped into logical categories for easy navigation\n- **🤖 AI Assistant Ready**: Works seamlessly with Claude Desktop and Cursor\n- **⚡ High Performance**: Built with Bun for fast execution and native TypeScript support\n- **🔧 Easy Installation**: Automated setup scripts with intelligent configuration detection\n\n\nhttps://github.com/user-attachments/assets/c3a5fe4c-e97e-4bcb-8140-a88c712a35cd\n\n\n## Quick Start\n\n1. **Prerequisites:**\n   ```bash\n   # Install Bun (if not already installed)\n   curl -fsSL https://bun.sh/install | bash\n   ```\n\n2. **Install and configure:**\n   ```bash\n   ./install.sh\n   ```\n\n3. **Add your Attio access token to `.env`:**\n   ```\n   ATTIO_ACCESS_TOKEN=your_token_here\n   ```\n   \n   Get your token from: https://app.attio.com/settings/api\n\n4. **Restart Claude Desktop or Cursor**\n\n## Manual Installation\n\n### For Claude Desktop\n\n```bash\n./install-claude.sh\n```\n\nThis will automatically:\n- Add the server to Claude's configuration\n- Configure authentication with your access token\n- Create a backup of existing configuration\n\n### For Cursor\n\n```bash\n./install-cursor.sh\n```\n\nThis will automatically:\n- Add the server to Cursor's settings\n- Configure authentication with your access token\n- Create a backup of existing settings\n\n## Available Tools\n\nThe MCP server exposes all Attio API endpoints as tools with human-readable names, organized by category:\n\n### Core Data Management\n- **Objects**: `list_objects`, `create_object`, `get_object`, `update_object`\n- **Records**: `list_records`, `create_record`, `query_records`, `delete_record`\n- **Attributes**: `list_attributes`, `create_attribute`, `update_attribute_status`\n\n### Lists \u0026 Entries\n- **Lists**: `list_lists`, `create_list`, `update_list`\n- **List Entries**: `create_list_entry`, `query_list_entries`, `update_list_entry`\n\n### Collaboration\n- **Tasks**: `list_tasks`, `create_task`, `update_task`, `delete_task`\n- **Notes**: `list_notes`, `create_note`, `get_note`, `delete_note`\n- **Comments**: `create_comment`, `get_comment`, `list_comment_threads`\n\n### Administration\n- **Workspace**: `list_workspace_members`, `get_workspace_member`\n- **Webhooks**: `list_webhooks`, `create_webhook`, `update_webhook`\n- **Authentication**: `get_current_user`\n\n## Manual Testing\n\nTo test the server directly:\n\n```bash\nbun start\n```\n\n## Configuration\n\nThe server uses the following environment variables:\n\n- `ATTIO_ACCESS_TOKEN`: Your Attio workspace access token (required)\n- `PORT`: Port for web transport (default: 3000)\n- `LOG_LEVEL`: Logging level (default: info)\n\n## Troubleshooting\n\n1. **Server not showing in Claude/Cursor:**\n   - Restart the application after installation\n   - Check the logs for any errors\n   - Ensure the server is built: `bun run build`\n\n2. **Authentication errors:**\n   - Verify your access token in `.env`\n   - Ensure the token has the necessary permissions\n\n3. **Build errors:**\n   - Run `bun install` to ensure all dependencies are installed\n   - Run `bun run build` to compile TypeScript\n\n## Development\n\nTo modify the server:\n\n1. Edit `src/index.ts`\n2. Run `bun run build`\n3. Test with `bun test`\n4. Restart Claude/Cursor to load changes\n\n### Development Commands\n\n```bash\n# Install dependencies\nbun install\n\n# Build the server\nbun run build\n\n# Run tests\nbun test\n\n# Run tests with coverage\nbun test --coverage\n\n# Format and lint code\nbun run check\n\n# Manual testing\nbun run test:manual\n```\n\n## Support\n\nFor issues with:\n- **This MCP server**: Create an issue in this repository\n- **Attio API**: Contact support@attio.com\n- **MCP Protocol**: Visit https://modelcontextprotocol.io\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.\n\n## License\n\nThis project is open source and available under the MIT License.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\u003csub\u003eBuilt with ❤️ for the AI community\u003c/sub\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitsbrex%2Fattio-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fitsbrex%2Fattio-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitsbrex%2Fattio-mcp-server/lists"}